크로스플레이 런처 원격 실행 API

개요¶

크로스플레이 런처 원격 실행 API는 크로스플레이 런처로 게임 실행 중 의도치 않게 게임이 종료되는 경우, 실행 중인 PC 목록을 조회하고 특정 PC를 선택하여 원격 실행하는 기능을 제공합니다.

크게 PC 목록 조회 API와 PC 원격 실행 API로 구성됩니다.

사전 조건¶

• Hive SDK v4.24.4.0 이상의 Windows 버전
• Crossplay Launcher 1.0.16.0 이상

기본 동작 플로우¶

• 게임별로 원격 실행 사용여부 설정

  Note

  현재는 수동으로 원격 실행 사용여부 설정 기능만 지원하며, 자동 설정 기능은 추후 제공 예정입니다.

• 크로스플레이 런처를 통해 Windows PC에서 게임 실행

• 게임에서 PC 목록 조회 API를 호출하여 크로스플레이 런처로 실행 중인 PC 목록 조회
• 조회 결과, PC 목록에서 선택한 PC 정보를 가지고 PC 원격 실행 API를 호출
  (선택된 PC로 외부 자동로그인 토큰을 전달합니다.)
• 외부 자동 로그인 토큰을 통해 크로스플레이 런처에서 게임 재접속 및 자동로그인 진행

PC 목록 조회 API¶

현재 크로스플레이 런처를 통해 실행 중인 PC이면서, 원격 실행이 가능한 PC 목록을 조회하는 API입니다.

Request URL 및 조건¶

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",
        },
        {
            "pc_name" : "pc2",
            "did" : "304166094"
        },
        ...
    ]
}

응답 코드 명세¶

PC 원격 실행 API¶

PC 목록 조회 API 요청 후 조회된 PC 목록 중 선택된 PC에서 원격 실행하도록 토큰 정보를 전달하는 API입니다.

Request URL 및 조건¶

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"
}

응답 코드 명세¶