Crossplay Launcher Remote Launch API

Overview¶

The cross-play launcher remote execution API provides the ability to query the list of running PCs and remotely execute on a specific PC in case the game unintentionally closes while running the game with the cross-play launcher.

It consists of the PC List Retrieval API and the PC Remote Execution API.

Prerequisites¶

• Windows version of Hive SDK v4.24.4.0 or higher
• Crossplay Launcher 1.0.16.0 or higher

Basic operation flow¶

• Set the remote execution usage for each game

  Note

Currently, only the manual remote execution usage setting function is supported, and the automatic setting function will be provided later.

• Launch games on Windows PC through the crossplay launcher
• Call the PC list query API in the game to retrieve the list of PCs running the crossplay launcher
• In the query results, call the PC remote execution API with the information of the selected PC from the PC list
  (The external auto-login token is passed to the selected PC.)
• Reconnect to the game and proceed with auto-login through the crossplay launcher using the external auto-login token

PC list retrieval API¶

This is an API to retrieve the list of PCs that are currently running through the crossplay launcher and are capable of remote execution.

Request URL and conditions¶

Request header¶

Request header sample¶

Content-Type : application/json
Authorization : Bearer b630b963152efa1f97a8c066831222

Request body¶

Request body sample¶

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

Response body¶

Response body sample¶

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

Response code specification¶

PC remote execution API¶

This is an API that delivers token information to remotely execute on the selected PC from the retrieved PC list after requesting the PC list query API.

Request URL and conditions¶

Request header¶

Request header sample¶

Content-Type : application/json
Authorization : Bearer b630b963152efa1f97a8c066831222

Request body¶

Request body sample¶

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

Response body¶

Response body sample¶

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

Response code specification¶