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

概要¶

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

それはPCリスト取得APIとPCリモート実行APIで構成されています。

前提条件¶

• Hive SDKのWindows版 v4.24.4.0以上
• Crossplay Launcher 1.0.16.0以上

基本的な操作フロー¶

• 各ゲームのリモート実行の使用設定

  Note

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

• クロスプレイランチャーを通じてWindows PCでゲームを起動する
• ゲーム内でPCリストクエリAPIを呼び出して、クロスプレイランチャーを実行しているPCのリストを取得する
• クエリ結果で、PCリストから選択したPCの情報を使ってPCリモート実行APIを呼び出す
  (外部自動ログイントークンが選択したPCに渡されます。)
• ゲームに再接続し、外部自動ログイントークンを使用してクロスプレイランチャーを通じて自動ログインを進める

PCリスト取得API¶

これは、現在クロスプレイランチャーを通じて実行中で、リモート実行が可能な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",
            "date": "20250210144909"
        },
        {
            "pc_name" : "pc2",
            "did" : "304166094",
            "date": "20250210144923"
        },
        ...
    ]
}

レスポンスコード仕様¶

PCリモート実行API¶

これは、取得したPCリストから選択したPCでリモート実行するためにトークン情報を提供するAPIです。PCリストクエリアPIをリクエストした後に実行されます。

リクエスト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"
}

レスポンスコード仕様¶