クロスプレイランチャーリモート実行API

概要¶

クロスプレイランチャーリモート実行APIは、実行中のPCのリストを照会し、クロスプレイランチャーで実行中にゲームが意図せず終了した場合に特定のPCを選択してリモートでゲームを実行する機能を提供します。

主にPCリストクエリアPIとPCリモート実行APIで構成されています。

前提条件¶

• Hive SDKのWindowsバージョン v4.24.4.0以上
• Crossplay Launcher 1.0.16.0以上

基本操作フロー¶

• 各ゲームに対してリモート実行を使用するかどうかを設定します

  Note

  現在、リモート実行を使用するかどうかの手動設定のみがサポートされており、自動設定機能は将来的に提供される予定です。

• Crossplay Launcherを介してWindows PCでゲームを実行します。

• ゲーム内でPCリストクエリAPIを呼び出して、Crossplay Launcherで実行されているPCのリストを照会します。
• クエリの結果としてPCリストから選択されたPCの情報を使ってPCリモート実行APIを呼び出します。
  (外部自動ログイントークンが選択されたPCに渡されます。)
• ゲームに再接続し、Crossplay Launcherからの外部自動ログイントークンを使用して自動ログインします。

PCリストクエリアPI¶

これは、現在Crossplay Launcherで実行中でリモート実行が可能なPCのリストを照会するAPIです。

リクエストURLと条件¶

リクエストヘッダー¶

リクエストヘッダーサンプル¶

Content-Type : application/json
Authorization : Bearer b630b963152efa1f97a8c066831222

リクエストボディ¶

リクエストボディのサンプル¶

{
    "appId" : "com.com2us.hivesdk.normal.freefull.google.global.android.common",
    "playerId" : "20000023036",
    "did" : "304166094"
}

レスポンスボディ¶

レスポンスボディサンプル¶

{
    "code": 100,
    "msg": "success",
    "data": [
        {
            "pc_name" : "pc1",
            "did" : "304162817",
        },
        {
            "pc_name" : "pc2",
            "did" : "304166094"
        },
        ...
    ]
}

レスポンスコード仕様¶

PCリモート実行API¶

これは、PCリスト照会APIをリクエストした後に取得したPCリストから選択されたPCをリモートで実行するためにトークン情報を送信するAPIです。

リクエストURLと条件¶

リクエストヘッダー¶

リクエストヘッダー¶

リクエストヘッダーサンプル¶

Content-Type : application/json
Authorization : Bearer b630b963152efa1f97a8c066831222

リクエストボディ¶

リクエストボディのサンプル¶

{
    "appId" : "com.com2us.hivesdk.normal.freefull.google.global.android.common",
    "playerId" : "20000023036",
    "did" : "304166094",
    "idpUserId" : "68261324",
    "idpIndex" : 1,
    "selected_did" : "304162817",
    "selected_pcName" : "pc1"
}

応答本文¶

レスポンスボディサンプル¶

{
    "code" : 100,
    "msg" : "success"
}

レスポンスコード仕様¶