API การเปิดตัวระยะไกลของ Crossplay Launcher
ภาพรวม¶
API การเรียกใช้ระยะไกลของ Crossplay Launcher มีฟังก์ชันในการสอบถามรายการของ PC ที่กำลังทำงานและเลือก PC เฉพาะเพื่อเรียกใช้เกมระยะไกลหากเกมถูกยกเลิกโดยไม่ตั้งใจในขณะที่ทำงานกับ Crossplay Launcher.
มันประกอบด้วย PC List Query API และ PC Remote Execution API เป็นหลัก
ข้อกำหนดเบื้องต้น¶
- เวอร์ชัน Windows ของ Hive SDK v4.24.4.0 หรือสูงกว่า
- Crossplay Launcher 1.0.16.0 หรือสูงกว่า
ขั้นตอนการทำงานพื้นฐาน¶
-  ตั้งค่าให้ใช้การดำเนินการระยะไกลสำหรับแต่ละเกม Noteขณะนี้ รองรับเพียงการตั้งค่าด้วยตนเองว่าใช้การดำเนินการระยะไกลหรือไม่ และฟังก์ชันการตั้งค่าอัตโนมัติจะมีให้ในอนาคต 
-  เรียกเล่นเกมบนพีซี Windows ผ่าน Crossplay Launcher. 
- เรียกใช้ PC List Query API ในเกมเพื่อตรวจสอบรายการพีซีที่ทำงานด้วย Crossplay Launcher.
- เรียกใช้ PC Remote Run API ด้วยข้อมูลของพีซีที่เลือกจากรายการพีซีเป็นผลลัพธ์ของการค้นหา.
 (โทเค็นการเข้าสู่ระบบอัตโนมัติภายนอกจะถูกส่งไปยังพีซีที่เลือก.)
- เชื่อมต่อกลับไปยังเกมและเข้าสู่ระบบอัตโนมัติด้วยโทเค็นการเข้าสู่ระบบอัตโนมัติภายนอกจาก Crossplay Launcher.
API ค้นหารายการ PC¶
นี่คือ API ที่สอบถามรายชื่อ PC ที่กำลังทำงานอยู่ด้วย Crossplay Launcher และสามารถทำการรันระยะไกลได้
Note
- การสอบถามรายการ PC เป็นไปได้เฉพาะเมื่อคำขอถูกต้องหลังจากการตรวจสอบผ่าน API Token Verification
URL และเงื่อนไขการร้องขอ¶
| หมวดหมู่ | URL และเงื่อนไข | 
|---|---|
| URL เชิงพาณิชย์ | https://api-launcherplay.withhive.com/api/pc/list | 
| URL SANDBOX | https://sandbox-api-launcherplay.withhive.com/api/pc/list | 
| วิธีการ HTTP | PUT | 
| รูปแบบข้อมูล | JSON | 
หัวข้อคำขอ¶
| ชื่อฟิลด์ | คำอธิบาย | ประเภท | จำเป็น | 
|---|---|---|---|
| Content-Type | application/json | String | Y | 
| Authorization | Bearer token key (Token key ที่ส่งคืนหลังจากเข้าสู่ระบบสำเร็จ) | String | Y | 
ตัวอย่างส่วนหัวของคำขอ¶
เนื้อหาคำขอ¶
| ชื่อฟิลด์ | คำอธิบาย | ประเภท | จำเป็น | 
|---|---|---|---|
| appId | AppID ของเกมที่เข้าสู่ระบบ | String | Y | 
| playerId | PlayerID ของการตรวจสอบสิทธิ์ V4 ที่ส่งกลับหลังจากเข้าสู่ระบบสำเร็จ | String | Y | 
| did | DID ที่ส่งกลับหลังจากเข้าสู่ระบบสำเร็จ | String | Y | 
ตัวอย่างเนื้อหาคำขอ¶
{
    "appId" : "com.com2us.hivesdk.normal.freefull.google.global.android.common",
    "playerId" : "20000023036",
    "did" : "304166094"
}
เนื้อหาการตอบกลับ¶
| ชื่อฟิลด์ | คำอธิบาย | ประเภท | |
|---|---|---|---|
| code | รหัสผลลัพธ์การตอบกลับ | จำนวนเต็ม | |
| msg | ข้อความผลลัพธ์การตอบกลับ | สตริง | |
| data | รายการของ PC ที่สามารถดำเนินการได้ | อาร์เรย์ | |
| ㄴ | pc_name | ชื่อ PC | สตริง | 
| ㄴ | did | ข้อมูลอุปกรณ์ | สตริง | 
ตัวอย่างเนื้อหาการตอบกลับ¶
{
    "code": 100,
    "msg": "success",
    "data": [
        {
            "pc_name" : "pc1",
            "did" : "304162817",
        },
        {
            "pc_name" : "pc2",
            "did" : "304166094"
        },
        ...
    ]
}
ข้อกำหนดรหัสการตอบกลับ¶
| รหัส | ข้อความ | คำอธิบาย | 
|---|---|---|
| 100 | สำเร็จ | สำเร็จ | 
| 101 | สำเร็จ(ไม่มีอยู่) | สำเร็จ └ อย่างไรก็ตาม เนื่องจากไม่มีรายการที่สามารถดำเนินการจากระยะไกลได้ ข้อมูลจึงไม่ถูกส่งกลับ | 
| 400 | ล้มเหลว(ข้อผิดพลาดพารามิเตอร์การอนุญาต) | พารามิเตอร์ส่วนหัวไม่ถูกต้อง └ การอนุญาต | 
| 401 | ล้มเหลว(ข้อผิดพลาดวิธีการ) | คำขอ HTTP METHOD ไม่ถูกต้อง | 
| 402 | ล้มเหลว(ข้อผิดพลาดพารามิเตอร์คำขอ) | พารามิเตอร์คำขอไม่มีอยู่ | 
| 403 | ล้มเหลว(ข้อผิดพลาดพารามิเตอร์ appId) | พารามิเตอร์ไม่ถูกต้อง └ appId | 
| 404 | ล้มเหลว(ข้อผิดพลาดพารามิเตอร์ playerId) | พารามิเตอร์ไม่ถูกต้อง └ playerId | 
| 405 | ล้มเหลว(ข้อผิดพลาดพารามิเตอร์ did) | พารามิเตอร์ไม่ถูกต้อง └ did | 
| 500 | ล้มเหลว(ข้อผิดพลาด hiveCertificationKey) | ไม่สามารถดึงข้อมูลเกมที่เกี่ยวข้อง (คีย์การรับรองความถูกต้องของ Hive) | 
| 501 | ล้มเหลว(####) | ข้อผิดพลาดอื่น #### เกิดขึ้นระหว่างการตรวจสอบเซิร์ฟเวอร์การรับรองความถูกต้อง | 
| 502 | ล้มเหลว(####) | ข้อผิดพลาดอื่น #### เกิดขึ้นระหว่างการดึงรายการ PC | 
| 503 | ล้มเหลว(####) | เมื่อเข้าถึง Redis เพื่อดึงรายการ PC จะเกิดข้อผิดพลาด #### | 
| 900 | ล้มเหลว(ข้อผิดพลาด curl - ####) | กำลังตรวจสอบเซิร์ฟเวอร์การรับรองความถูกต้อง เกิดข้อผิดพลาด curl เมื่อเรียก API (เกิดข้อผิดพลาด ####) | 
| 901 | ล้มเหลว(ข้อผิดพลาด api - ####) | การตรวจสอบเซิร์ฟเวอร์การรับรองความถูกต้องล้มเหลว (เกิดข้อผิดพลาด ####) | 
API การดำเนินการระยะไกลของ PC¶
นี่คือ API ที่ส่งข้อมูลโทเค็นเพื่อดำเนินการพีซีที่เลือกจากรายการพีซีที่ดึงมาได้หลังจากขอ PC List Inquiry API
Note
- API นี้ส่งโทเค็นการเข้าสู่ระบบอัตโนมัติภายนอกไปยัง PC ที่เลือก และการดำเนินการระยะไกลจริง (การเข้าถึงเกมและการเข้าสู่ระบบอัตโนมัติ) จะทำงานใน Crossplay Launcher
- จะสามารถใช้งานได้เฉพาะเมื่อคำขอถูกต้องหลังจากการตรวจสอบผ่าน API Token Verification
URL และเงื่อนไขการร้องขอ¶
| หมวดหมู่ | URL และเงื่อนไข | 
|---|---|
| URL เชิงพาณิชย์ | https://api-launcherplay.withhive.com/api/pc/remoteplay | 
| URL SANDBOX | https://sandbox-api-launcherplay.withhive.com/api/pc/remoteplay | 
| วิธีการ HTTP | POST | 
| รูปแบบข้อมูล | JSON | 
ส่วนหัวคำขอ¶
ส่วนหัวคำขอ¶
| ชื่อฟิลด์ | คำอธิบาย | ประเภท | จำเป็น | 
|---|---|---|---|
| Content-Type | application/json | String | Y | 
| Authorization | Bearer token key (Token key ที่ส่งคืนหลังจากเข้าสู่ระบบสำเร็จ) | String | Y | 
ตัวอย่างหัวข้อคำขอ¶
เนื้อหาคำขอ¶
| ชื่อฟิลด์ | คำอธิบาย | ประเภท | จำเป็น | 
|---|---|---|---|
| appId | AppID ของเกมที่เข้าสู่ระบบ | String | Y | 
| playerId | PlayerID การรับรองความถูกต้อง V4 ที่ส่งคืนหลังจากการเข้าสู่ระบบสำเร็จ | String | Y | 
| did | DID ที่ส่งคืนหลังจากการเข้าสู่ระบบสำเร็จ | String | Y | 
| idpUserId | ค่า ID สมาชิกที่จัดเตรียมโดย IDP หลังจากการเข้าสู่ระบบสำเร็จ | String | Y | 
| idpIndex | ข้อมูล INDEX ของ IDP 1: HIVE 2: Facebook 3: GOOGLE 9: APPLE | Integer | Y | 
| selected_did | ในผลลัพธ์การค้นหาของ /api/pc/list DID ของ PC ที่เลือก | String | Y | 
| selected_pcName | ในผลลัพธ์การค้นหาของ /api/pc/list ชื่อ PC ที่เลือก | String | Y | 
ตัวอย่างเนื้อหาคำขอ¶
{
    "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 | รหัสผลลัพธ์การตอบกลับ | จำนวนเต็ม | 
| msg | ข้อความผลลัพธ์การตอบกลับ | สตริง | 
ตัวอย่างเนื้อหาการตอบกลับ¶
ข้อกำหนดรหัสการตอบสนอง¶
| รหัส | ข้อความ | คำอธิบาย | 
|---|---|---|
| 100 | สำเร็จ | สำเร็จ | 
| 400 | ล้มเหลว(ข้อผิดพลาดพารามิเตอร์การอนุญาต) | ข้อผิดพลาดพารามิเตอร์ส่วนหัว └ การอนุญาต | 
| 401 | ล้มเหลว(ข้อผิดพลาดพารามิเตอร์คำขอ) | พารามิเตอร์คำขอไม่มี | 
| 402 | ล้มเหลว(ข้อผิดพลาดพารามิเตอร์ appId) | ข้อผิดพลาดพารามิเตอร์ └ appId | 
| 403 | ล้มเหลว(ข้อผิดพลาดพารามิเตอร์ playerId) | ข้อผิดพลาดพารามิเตอร์ └ playerId | 
| 404 | ล้มเหลว(ข้อผิดพลาดพารามิเตอร์ did) | ข้อผิดพลาดพารามิเตอร์ └ did | 
| 405 | ล้มเหลว(ข้อผิดพลาดพารามิเตอร์ idpUserId) | ข้อผิดพลาดพารามิเตอร์ └ idpUserId | 
| 406 | ล้มเหลว(ข้อผิดพลาดพารามิเตอร์ idpIndex) | ข้อผิดพลาดพารามิเตอร์ └ idpIndex | 
| 407 | ล้มเหลว(ข้อผิดพลาดพารามิเตอร์ selected_did) | ข้อผิดพลาดพารามิเตอร์ └ selected_did | 
| 408 | ล้มเหลว(ข้อผิดพลาดพารามิเตอร์ selected_pcName) | ข้อผิดพลาดพารามิเตอร์ └ selected_pcName | 
| 409 | ล้มเหลว(ข้อผิดพลาดวิธีการ) | คำขอด้วย HTTP METHOD ที่ไม่ถูกต้อง | 
| 500 | ล้มเหลว(ข้อผิดพลาด hiveCertificationKey) | ไม่สามารถดึงข้อมูลเกมที่เกี่ยวข้อง (คีย์การตรวจสอบสิทธิ์ Hive) | 
| 501 | ล้มเหลว(####) | ในระหว่างการตรวจสอบสิทธิ์เซิร์ฟเวอร์เกิดข้อผิดพลาด #### | 
| 502 | ล้มเหลว(ปัจจุบันไม่มีอยู่หรือไม่สามารถใช้งานได้) | ล้มเหลวเนื่องจากข้อมูล PC ที่เลือกไม่ได้เชื่อมต่อในขณะนี้ | 
| 503 | ล้มเหลว(####) | เมื่อเข้าถึง Redis เพื่อตรวจสอบข้อมูล PC ที่เลือกเกิดข้อผิดพลาด #### | 
| 504 | ล้มเหลว(มีมากกว่า 2 รายการ) | หากมีการเชื่อมต่อมากกว่า 2 รายการที่สอดคล้องกับข้อมูล PC ที่เลือก จะล้มเหลว. └ หมายเหตุ: เกิดขึ้นเมื่อ playerId, did และชื่อ PC เหมือนกันทั้งหมด. | 
| 505 | ล้มเหลว(####) | ตรวจสอบข้อมูล PC ที่เลือกเกิดข้อผิดพลาด #### | 
| 506 | ล้มเหลว(####) | การดึงข้อมูลที่เกี่ยวข้องกับโทเค็นการเข้าสู่ระบบอัตโนมัติภายนอก (enc_idp และ web_idp_token) เกิดข้อผิดพลาด #### | 
| 507 | ล้มเหลว(ข้อผิดพลาดการเผยแพร่) | ไม่สามารถส่งโทเค็นการเข้าสู่ระบบอัตโนมัติภายนอกไปยัง PC ที่เลือกได้. ᄂ หมายเหตุ: เกิดขึ้นเมื่อจำนวน PC ที่ได้รับข้อความน้อยกว่า 1 (ค่าผลลัพธ์การเผยแพร่ redis). | 
| 508 | ล้มเหลว(####) | เมื่อเข้าถึง Redis เพื่อส่งโทเค็นการเข้าสู่ระบบอัตโนมัติภายนอกไปยัง PC ที่เลือกเกิดข้อผิดพลาด #### | 
| 509 | ล้มเหลว(####) | ส่งโทเค็นการเข้าสู่ระบบอัตโนมัติภายนอกไปยัง PC ที่เลือกเกิดข้อผิดพลาด #### | 
| 900 | ล้มเหลว(ข้อผิดพลาด curl - ####) | กำลังดำเนินการตรวจสอบสิทธิ์เซิร์ฟเวอร์, เกิดข้อผิดพลาด curl เมื่อเรียก API (เกิดข้อผิดพลาด ####) | 
| 901 | ล้มเหลว(ข้อผิดพลาด api - ####) | การตรวจสอบสิทธิ์เซิร์ฟเวอร์ล้มเหลว (เกิดข้อผิดพลาด ####) | 
| 902 | ล้มเหลว(ข้อผิดพลาด curl - ####) | กำลังดำเนินการดึงค่า enc_idp สำหรับการดึงโทเค็นการเข้าสู่ระบบอัตโนมัติภายนอก, เกิดข้อผิดพลาด curl เมื่อเรียก API (เกิดข้อผิดพลาด ####) | 
| 903 | ล้มเหลว(ข้อผิดพลาด api - ####) | การดึงค่า enc_idp สำหรับการดึงโทเค็นการเข้าสู่ระบบอัตโนมัติภายนอกล้มเหลว (เกิดข้อผิดพลาด ####) | 
| 904 | ล้มเหลว(ข้อผิดพลาด curl - ####) | กำลังดำเนินการดึงโทเค็นการเข้าสู่ระบบอัตโนมัติภายนอก (web_idp_token), เกิดข้อผิดพลาด curl เมื่อเรียก API (เกิดข้อผิดพลาด ####) | 
| 905 | ล้มเหลว(ข้อผิดพลาด api - ####) | การดึงโทเค็นการเข้าสู่ระบบอัตโนมัติภายนอก (web_idp_token) ล้มเหลว (เกิดข้อผิดพลาด ####) |