ข้ามไปที่เนื้อหา

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

หน้านี้แนะนำ Authentication v4 ซึ่งเป็นระบบการตรวจสอบสิทธิ์ใหม่ของแพลตฟอร์ม Hive ที่มีให้บริการตั้งแต่ Hive SDK v4.3.0. Authentication v4 จัดการกระบวนการต่างๆ ตั้งแต่การเริ่มต้น SDK ของ Hive ไปจนถึงการเข้าสู่ระบบ.

Note

หากคุณต้องการพัฒนาเกมด้วย Authentication v1 โปรดดูการพัฒนาด้วย SDK v4 โดยใช้เมนู Authentication v1.

การประกอบ

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

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

คุณสมบัติ

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

ตัวช่วยสำหรับการตรวจสอบสิทธิ์ v4

Hive SDK v4.7.0 มี AuthV4.Helper ซึ่งเป็นฟีเจอร์ใหม่สำหรับการลงชื่อเข้าใช้ที่รวดเร็วและง่ายดาย

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

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

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

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

IdP คำอธิบาย เงื่อนไขการเปิดเผย / เวอร์ชันที่รองรับ
Hive Membership ยืนยันตัวตนผู้ใช้ด้วยอีเมลและรหัสผ่านบัญชีสมาชิก Hive ไม่มีเงื่อนไขพิเศษ
Facebook ยืนยันตัวตนด้วยบัญชี Facebook ไม่แสดงหากประเทศของผู้ใช้คือจีน (CN)
Google Play Games ยืนยันตัวตนด้วยบัญชีโปรไฟล์ Google Play Games (แตกต่างจากการเข้าสู่ระบบ Google) เฉพาะ Android เท่านั้น ไม่แสดงหากประเทศของผู้ใช้คือจีน
Google ยืนยันตัวตนด้วยบัญชีอีเมล Google (รองรับ iOS และแพลตฟอร์มอื่น ๆ นอกเหนือจาก Android) ไม่แสดงหากประเทศของผู้ใช้คือจีน บน Android สามารถแสดง Google และ Google Play Games พร้อมกัน — แยกด้วยไอคอน: icon
Game Center ยืนยันตัวตนด้วยบัญชี Apple Game Center แสดงเฉพาะบน iOS
QQ ยืนยันตัวตนด้วยบัญชี Tencent QQ แสดงเฉพาะเมื่อประเทศของผู้ใช้คือจีนหรือภาษาของเกมคือภาษาจีนตัวย่อ การเข้าสู่ระบบ QQ รองรับตั้งแต่ Hive SDK v4.5.0
VK ยืนยันตัวตนด้วยบัญชี VK แสดงเฉพาะเมื่อภาษาของเกมคือภาษารัสเซีย ไม่แสดงหากประเทศของผู้ใช้คือจีน การเข้าสู่ระบบ VK รองรับตั้งแต่ Hive SDK v4.6.0
WeChat ยืนยันตัวตนด้วยบัญชี WeChat แสดงเฉพาะเมื่อประเทศของผู้ใช้คือจีนหรือภาษาของเกมคือภาษาจีนตัวย่อ การเข้าสู่ระบบ WeChat รองรับตั้งแต่ Hive SDK v4.6.0
Apple ยืนยันตัวตนด้วยบัญชี Apple แสดงบน iOS 13+ การเข้าสู่ระบบ Apple รองรับตั้งแต่ Hive SDK v4.11.7.3
SignInWithApple ยืนยันตัวตนด้วยบัญชี Apple บน Android รองรับบน Android API 21+ รองรับตั้งแต่ Hive SDK v4.15.6
LINE ยืนยันตัวตนด้วยบัญชี LINE แสดงบน Android SDK 17 และ iOS 10+ การเข้าสู่ระบบ LINE รองรับตั้งแต่ Hive SDK v4.14.0
Weverse ยืนยันตัวตนด้วยบัญชี Weverse แสดงบน iOS 12+ การเข้าสู่ระบบ Weverse รองรับตั้งแต่ Hive SDK v4.15.2
Huawei ยืนยันตัวตนด้วยบัญชี Huawei แสดงเฉพาะบน Android เท่านั้น การเข้าสู่ระบบ Huawei รองรับตั้งแต่ Hive SDK v4.16.2

ตัวระบุผู้ใช้

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

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

PlayerID ตัวอย่าง

NO PlayerID เกม Hive สมาชิก Facebook Google Play Games Game Center
1 10001 A X F10000 G10000 A10000
2 10002 A H10000 X G20000 X
3 20001 B H10000 X X X
4 20003 B X X X X
  • ผู้ใช้หมายเลข 1 ทำการซิงค์ PlayerID กับ IdP สามราย; Facebook, Google Play Games และ Apple Game Center.
  • ผู้ใช้หมายเลข 1 และ 2 ทำการซิงค์ PlayerID จากเกมหนึ่งกับรหัสผู้ใช้สองรหัสที่แตกต่างกันของ Google Play Games.
  • ผู้ใช้หมายเลข 2 และ 3 ทำการซิงค์บัญชีสมาชิก Hive เดียวกันกับ PlayerIDs ของเกมที่แตกต่างกันสองเกม.
  • ผู้ใช้หมายเลข 4 เป็นผู้ใช้ที่ไม่ระบุชื่อที่ทำการซิงค์กับ IdP ใด ๆ.