Unity(PC、ウェブ)向けのSDK / 注文状況を追跡する
  ドキュメントに戻る

Unity(PC、ウェブ)向けのSDK

注文状況を追跡する

注意
SDKはアプリケーションのクライアント側で注文のステータスを追跡することを可能にします。ただし、完了した購入の追加の検証を実装するために、アプリケーションのバックエンドで支払いウェブフックハンドラを設定することをお勧めします。これにより、注文情報を受け取ることができます。
ユーザーが購入した後、アプリケーションは以下のアクションを実行することができます:
  • アプリケーションUIに注文状態を表示する
  • 支払い完了後、ユーザーの残高を計上する
  • 支払い完了後、購入したアイテムを付与する
注文追跡ロジックは、次のSDKメソッドに含まれています:
  • Cart.Purchase — カートを購入するのに使用されます
  • Cart.PurchaseFreeCart — カート経由で無料アイテムを購入するために使用されます
  • Catalog.Purchase — ワンクリックでアイテムを購入するために使用されます
  • Catalog.PurchaseForVirtualCurrency — 仮想通貨のアイテムの購入に使用されます
  • Catalog.PurchaseFreeItem — ワンクリックで無料アイテムを購入するために使用されます
SDK参照ドキュメンテーション
SDKメソッドとそのパラメータの詳細については、こちらをご覧ください。

購入が成功した場合の処理としては、注文がdoneステータスに遷移したときに呼び出される関数をonSuccessパラメータに渡すだけです。

購入メソッドには、注文ステータスを追跡するためのいくつかのメソッドがカプセル化されています。メカニズムは、アプリケーションが構築されているプラットフォームによって異なります:

  • WebGLビルドの場合、追跡は決済インターフェイスウィジェットのpostMessageイベントに基づいています。「ペイステーション」ウィジェットが注文状態が「done」または「cancel」に変更されたというメッセージを送信すると、追跡は停止します。

  • 他のプラットフォーム向けのビルドの場合、追跡には単純なHTTPリクエスト(ショートポーリング)とウェブソケットリクエストが使用されます。追跡は、次のアルゴリズムに従って実行されます:

    1. ウェブソケット接続が確立されます。
    2. 5分以内に注文状態が「done」または「cancel」に変更されなかった場合、ウェブソケット接続閉じられています。注文状態が「done」または「cancel」に変更された場合、追跡は停止します。
    3. 注文状態の追跡は、ショートポーリングで続行されます。シンプルなHTTP注文状態リクエストが3秒ごとに送信されます。追跡は以下の場合に停止します:
      • 注文状態が「done」または「cancel」に変更されます
      • 注文状態が10分以内に「done」または「cancel」に変更されます
お知らせ
ウェブソケット接続に失敗した場合、ショートポーリングを利用して注文状態を追跡します。
onSuccessコールバック関数の中で渡される注文コンテンツデータの処理を実装することもできます。
この記事は役に立ちましたか?
ありがとうございます!
改善できることはありますか? メッセージ
申し訳ありません
この記事が参考にならなかった理由を説明してください。 メッセージ
ご意見ありがとうございました!
あなたのメッセージを確認し、体験を向上させるために利用させていただきます。

お役立ちリンク

最終更新日: 2024年1月22日

誤字脱字などのテキストエラーを見つけましたか? テキストを選択し、Ctrl+Enterを押します。

問題を報告する
当社は常にコンテンツを見直しています。お客様のご意見は改善に役立ちます。
フォローアップ用のメールをご提供してください
ご意見ありがとうございました!