วิธีการใช้การตรวจสอบสิทธิ์¶

หน้านี้แนะนำ การตรวจสอบสิทธิ์ ซึ่งเป็นระบบการตรวจสอบสิทธิ์ใหม่ของ Hive Platform ที่มีให้ตั้งแต่ Hive SDK 4.3.0 การตรวจสอบสิทธิ์ จัดการชุดกระบวนการตั้งแต่การเริ่มต้น SDK ไปจนถึงการเข้าสู่ระบบ

การประกอบ¶

การตรวจสอบสิทธิ์ประกอบด้วยสามขั้นตอน.

1. การเริ่มต้น SDK
   • หลังจากเริ่มต้น SDK คุณสามารถใช้ฟังก์ชันทั้งหมดที่ SDK มีให้
   • ขั้นตอนการเริ่มต้นจะแสดงเงื่อนไขการให้บริการรวมถึงป๊อปอัพการอัปเดต/ประกาศ
   • ขั้นตอนการเริ่มต้นจะแสดงป๊อปอัพการอนุญาตเฉพาะบนอุปกรณ์ที่ใช้ Android เท่านั้น
2. การแสดงเมนูการเลือกเซิร์ฟเวอร์เกมและป๊อปอัพการบำรุงรักษา
   • ให้เมนูการเลือกเซิร์ฟเวอร์เกมแก่ผู้ใช้หลังจากการเริ่มต้น SDK.
   • แสดงป๊อปอัพการบำรุงรักษาเซิร์ฟเวอร์หลังจากการเลือกเซิร์ฟเวอร์เกม.
3. การลงชื่อเข้าใช้
   • การเป็นสมาชิกและ ID Provider ที่หลากหลาย (IdP) สามารถใช้เพื่อเข้าสู่เกมผ่านการตรวจสอบสิทธิ์.

คุณสมบัติ¶

• การตรวจสอบสิทธิ์มีความยืดหยุ่นในการใช้งานกับ IdP ที่หลากหลาย เช่น Apple Game Center, Google Play Games, และ Facebook.
  • สามารถเข้าสู่ระบบด้วยบัญชีโซเชียลมีเดีย เช่น Facebook ได้โดยไม่คำนึงถึงสมาชิก.
  • การเข้าสู่ระบบโดยอัตโนมัติสามารถใช้ได้กับบัญชี Apple Game Center หรือบัญชี Google Play Games ที่ตั้งค่าไว้ในอุปกรณ์ของผู้ใช้.
• รองรับ UI ที่ปรับแต่งได้สำหรับการตรวจสอบสิทธิ์และขั้นตอนการเข้าสู่ระบบ.
  • หากจำเป็น ให้ออกแบบ UI ใหม่ด้วย API ที่กำหนดโดยปฏิบัติตามแนวคิดของเกมแทนที่จะใช้ UI ที่ให้โดย SDK.
• รองรับการเข้าสู่ระบบที่เสถียรผ่านเซิร์ฟเวอร์ที่กระจาย.
  • ผู้ใช้สามารถเข้าสู่ระบบเกมได้แม้จะมีปัญหากับสายอินเทอร์เน็ตระหว่างประเทศหรือความล้มเหลวของเซิร์ฟเวอร์ Hive โดยใช้เซิร์ฟเวอร์ที่กระจายอยู่ภายนอกเกาหลี.

AuthV4.Helper¶

การตรวจสอบสิทธิ์ให้ AuthV4.Helper เพื่อทำให้ฟังก์ชันการเข้าสู่ระบบง่ายและรวดเร็วในการนำไปใช้

• คุณสามารถค้นหา API ที่อัปเกรดแล้วซึ่งเปรียบเทียบสองบัญชี; หนึ่งสำหรับการเล่นเกม และอีกหนึ่งสำหรับการเข้าสู่ระบบบนอุปกรณ์ของผู้ใช้
  • บัญชีสำหรับ Google Play Games หรือ Apple Game Center บนอุปกรณ์จะถูกเปรียบเทียบกับบัญชีที่ซิงค์กับ PlayerID.
• คุณไม่จำเป็นต้องตรวจสอบข้อมูลจากเกม เพียงแค่ดูที่ไฟล์ SDK.
  • ผู้ให้บริการ ID ที่เหมาะสม (IdP) จะแสดงโดยการตรวจสอบข้อมูลประเทศ (เช่น หากข้อมูลประเทศคือจีน (CN) บัญชีผู้ใช้จะถูกซ่อนจากรายการ IdP.)
  • IdP ที่เหมาะสมจะแสดงโดยการระบุประเภท OS ของอุปกรณ์ (เช่น หากประเภท OS ของอุปกรณ์อิงจาก Google และข้อมูลประเทศคือจีน (CN) Google Play Games จะถูกซ่อนจากรายการ IdP.)
• คุณสามารถดำเนินการตามแนวทางที่เรียบง่ายสำหรับการซิงค์กับ SDK.
  • ส่วนที่ไม่จำเป็นในการใช้งานกับ API ของ Hive server เพื่อปฏิบัติตามแนวทางจะถูกตัดออก.
  • การอัปเดตทำให้เข้าใจและใช้งานได้ง่ายกว่าการใช้ API ของ Hive server.

ผู้ให้บริการที่มีอยู่¶

ตามที่ได้อธิบายไว้ก่อนหน้านี้ การตรวจสอบสิทธิ์จะตรวจสอบผู้ใช้ด้วย IdP ผู้ใช้สามารถใช้ IdP ที่ซิงค์ไว้ก่อนหน้านี้หรือเลือกอื่น ๆ เพื่อเชื่อมโยงกับบัญชีที่ลงชื่อเข้าใช้ IdP ที่ให้มาสามารถตั้งค่าแตกต่างกันไปตามเกม และแพลตฟอร์ม Hive จะเปิดเผย IdP ที่เหมาะสมให้กับผู้ใช้ตามข้อมูลประเทศของผู้ใช้

IdPs ที่จัดเตรียมไว้ใน Authentication¶

IdP	คำอธิบาย	เงื่อนไขการเปิดเผย / เวอร์ชันที่รองรับ
Membership	ยืนยันตัวตนผู้ใช้ด้วยอีเมลและรหัสผ่านบัญชี Membership	ไม่มีเงื่อนไขพิเศษ
Facebook	ยืนยันตัวตนด้วยบัญชี Facebook	ไม่แสดงหากประเทศของผู้ใช้คือจีน (CN)
Google Play Games	ยืนยันตัวตนด้วยบัญชีโปรไฟล์ Google Play Games (แตกต่างจากการเข้าสู่ระบบ Google)	เฉพาะ Android เท่านั้น ไม่แสดงหากประเทศของผู้ใช้คือจีน
Google	ยืนยันตัวตนด้วยบัญชีอีเมล Google (รองรับ iOS และแพลตฟอร์มอื่นๆ นอกเหนือจาก Android)	ไม่แสดงหากประเทศของผู้ใช้คือจีน บน Android Google และ Google Play Games สามารถแสดงพร้อมกันได้ — แยกตามไอคอน:
Game Center	ยืนยันตัวตนด้วยบัญชี Apple Game Center	แสดงเฉพาะบน iOS
QQ	ยืนยันตัวตนด้วยบัญชี Tencent QQ	แสดงเฉพาะเมื่อประเทศของผู้ใช้คือจีนหรือภาษาของเกมคือภาษาจีนแบบย่อ การเข้าสู่ระบบ QQ รองรับตั้งแต่ Hive SDK 4.5.0
VK	ยืนยันตัวตนด้วยบัญชี VK	แสดงเฉพาะเมื่อภาษาของเกมคือภาษารัสเซีย ไม่แสดงหากประเทศของผู้ใช้คือจีน การเข้าสู่ระบบ VK รองรับตั้งแต่ Hive SDK 4.6.0
WeChat	ยืนยันตัวตนด้วยบัญชี WeChat	แสดงเฉพาะเมื่อประเทศของผู้ใช้คือจีนหรือภาษาของเกมคือภาษาจีนแบบย่อ การเข้าสู่ระบบ WeChat รองรับตั้งแต่ Hive SDK 4.6.0
Apple	ยืนยันตัวตนด้วยบัญชี Apple	แสดงบน iOS 13+ การเข้าสู่ระบบ Apple รองรับตั้งแต่ Hive SDK 4.11.7.3
Sign in with Apple	ยืนยันตัวตนด้วยบัญชี Apple บน Android	รองรับบน Android API 21+ รองรับตั้งแต่ Hive SDK 4.15.6
LINE	ยืนยันตัวตนด้วยบัญชี LINE	แสดงบน Android SDK 17 และ iOS 10+ การเข้าสู่ระบบ LINE รองรับตั้งแต่ Hive SDK 4.14.0
Weverse	ยืนยันตัวตนด้วยบัญชี Weverse	แสดงบน iOS 12+ การเข้าสู่ระบบ Weverse รองรับตั้งแต่ Hive SDK 4.15.2
Huawei	ยืนยันตัวตนด้วยบัญชี Huawei	แสดงเฉพาะบน Android เท่านั้น การเข้าสู่ระบบ Huawei รองรับตั้งแต่ Hive SDK 4.16.2
X	ยืนยันตัวตนด้วยบัญชี X	รองรับการเข้าสู่ระบบ X ตั้งแต่ Hive SDK 4.24.5
Steam	ยืนยันตัวตนด้วยบัญชี Steam	รองรับการเข้าสู่ระบบ Steam ตั้งแต่ Hive SDK 4.24.5
Telegram	ยืนยันตัวตนด้วยบัญชี Telegram	รองรับการเข้าสู่ระบบ Telegram ตั้งแต่ Hive SDK 4.25.0
XIAOMI	ยืนยันตัวตนด้วยบัญชี XIAOMI	แสดงเฉพาะบน Android เท่านั้น รองรับการเข้าสู่ระบบ XIAOMI ตั้งแต่ Hive SDK 4.25.5.1
Funtap	ยืนยันตัวตนด้วยบัญชี Funtap	สำหรับเวียดนาม Funtap Appraisal Build เท่านั้น. รองรับการเข้าสู่ระบบ Funtap ตั้งแต่ Hive SDK 4.26.2

รหัสผู้ใช้¶

ในการตรวจสอบสิทธิ์ PlayerID เป็นกุญแจเฉพาะที่ใช้ในการระบุผู้ใช้ PlayerID มีลักษณะดังต่อไปนี้:

• สามารถซิงค์กับ IdP ที่หลากหลายได้
• PlayerID หนึ่งตัวไม่สามารถมีผู้ใช้ ID มากกว่าหนึ่งตัวจาก IdP เดียว
• ผู้ใช้ ID ของ IdP หนึ่งตัวไม่สามารถเชื่อมโยงกับหลาย PlayerID ในเกมเดียวกันได้
• PlayerID จะถูกออกให้แตกต่างกันสำหรับแต่ละเกมแม้ว่าจะใช้บัญชี IdP เดียวกัน
• ผู้ใช้ที่ซิงค์กับ IdP ใด ๆ ที่ Authentication ให้บริการจะเป็นผู้ใช้แบบแขก

PlayerID ตัวอย่าง¶

• ผู้ใช้หมายเลข 1 ซิงค์ PlayerID กับ IdPs สามตัว; Facebook, Google Play Games และ Apple Game Center.
• ผู้ใช้หมายเลข 1 และ 2 ซิงค์แต่ละ PlayerID จากเกมหนึ่งกับรหัสผู้ใช้ที่แตกต่างกันสองรหัสของ Google Play Games.
• ผู้ใช้หมายเลข 2 และ 3 ซิงค์บัญชีสมาชิกเดียวกันกับ PlayerIDs ของเกมที่แตกต่างกันสองเกม.
• ผู้ใช้หมายเลข 4 เป็นผู้ใช้แขกที่ไม่ได้ซิงค์กับ IdP ใด ๆ.