シームレス認証を有効にする方法

どのように動作するか

ランチャーを配布しているウェブサイトにユーザーがログインすると、ランチャーアカウントが自動的にログインされ、ウェブサイトからランチャーを介してゲームにユーザーデータを転送することができます。

入手方法

シームレスな認証を有効にするには、次を実装します:

  1. ワンタイムパスワードの取得
  2. インストーラー名にワンタイムパスワードの追加
  3. ゲームに送信されるユーザーデータの処理(任意)

ワンタイムパスワードの取得

ワンタイムパスワードの取得を実装するには:

  • エクソーラログインを使用する場合は、https://launcher.xsolla.com/otp URLへのPOSTリクエストを実装します。リクエスト本文に、以下のパラメータを持つJSONを渡します:
    • refresh_token - ユーザーリフレッシュトークン。
    • access_token - ユーザーアクセストークン。
    • tracking_payload - ゲームに転送する必要があるユーザーデータ。文字列の長さは最大255文字です。

お知らせ
tracking_payloadパラメータを使用する場合、その値を空にすることはできません。
注意
この機能は、OAuth 2.0認証を接続している場合のみ利用可能です。

エクソーラログインを使用してワンタイムパスワードを取得するリクエストの例:

Copy
Full screen
Small screen

    curl -X POST "https://launcher.xsolla.com/otp" -H  "accept: application/json" -H  "Content-Type: application/json" -d "{  \"access_token\": \"string\",  \"refresh_token\": \"string\",  \"tracking_payload\": \"string\"}"

    • エクソーラログインを使用していない場合は、ゲームに転送する必要があるユーザーデータをtracking_payloadクエリパラメータで送信します。文字列の長さは最大255文字です。

    エクソーラログインが使用されていない場合のワンタイムパスワードを取得するリクエストの例:

    Copy
    Full screen
    Small screen

      curl
      -X POST
      "https://launcher.xsolla.com/otp?tracking_payload=<tracking_payload>"
      -H
      "accept: application/json"
      -H
      "Content-Type: application/json"

      お知らせ
      tracking_payloadパラメータを使用する場合、その値を空にすることはできません。

      ワンタイムパスワードをインストーラー名に追加する

      受信したワンタイムパスワードは、UUIDフォーマットの36文字の文字列です。以下のフォーマットでダウンロードする際に、インストールファイル名にワンタイムパスワードを追加することを実装します:LauncherName_<OTP>.exe<OTP>はワンタイムパスワードです。

      ゲームによるユーザーデータの取得

      ランチャーは、以下の例のように、tracking_payloadパラメータで受け取ったデータを、コマンドライン引数--tracking_payloadの値として渡します。

      Copy
      Full screen
      Small screen

        game.exe --tracking_payload <tracking_payload> WU9VUiBEQVRBIEhFUkU=

        お知らせ
        ランチャーは、ゲームを起動するたびに、ユーザーデータをゲームに送信します。
        この記事は役に立ちましたか?
        ありがとうございます!
        改善できることはありますか? メッセージ
        申し訳ありません
        この記事が参考にならなかった理由を説明してください。 メッセージ
        ご意見ありがとうございました!
        あなたのメッセージを確認し、体験を向上させるために利用させていただきます。
        このページを評価する
        このページを評価する
        改善できることはありますか?

        答えたくない

        ご意見ありがとうございました!
        最終更新日: 2021年2月4日

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

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