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

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

หน้านี้แนะนำ 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 ที่มีอยู่กับการตรวจสอบสิทธิ์ v4
    • Hive membership: ตรวจสอบผู้ใช้ด้วยอีเมลและรหัสผ่านบัญชี Hive.
    • Facebook: ตรวจสอบผู้ใช้ด้วยบัญชี Facebook. หาก IP ของผู้ใช้อยู่ในจีน, จะไม่เปิดเผย.
    • Google Play Games: ตรวจสอบสิทธิ์ด้วยบัญชีโปรไฟล์ Google Play Games และรองรับเฉพาะแพลตฟอร์ม Android. หากผู้ใช้มาจากจีน, IdP นี้จะไม่เปิดเผย. IdP นี้แตกต่างจากการลงชื่อเข้าใช้ Google ด้านล่าง.
    • Google: ตรวจสอบสิทธิ์ด้วยบัญชีอีเมล Google, และรองรับ Android และแพลตฟอร์มอื่น ๆ รวมถึง iOS. สำหรับแพลตฟอร์ม Android, Google Play Games และการลงชื่อเข้าใช้ Google สามารถให้พร้อมกันได้, และสามารถแยกแยะได้ด้วยไอคอนต่อไปนี้.
    • Game Center: ตรวจสอบผู้ใช้ด้วยบัญชี Apple Game Center ซึ่งเปิดเผยเฉพาะบนอุปกรณ์ที่ใช้ iOS.
    • QQ: ตรวจสอบผู้ใช้ด้วยบัญชี Tencent QQ ซึ่งเปิดเผยหาก IP ของผู้ใช้อยู่ในจีนหรือภาษาของเกมเป็นภาษาจีนแบบย่อ. ใช้งานได้กับ Hive SDK v4.5.0 และเวอร์ชันที่ใหม่กว่า.
    • VK: ตรวจสอบผู้ใช้ด้วยบัญชี VK ซึ่งเปิดเผยหากภาษาของเกมเป็นภาษารัสเซีย, และไม่แสดงสำหรับผู้ที่เข้าถึงจากจีน. ใช้งานได้กับ Hive SDK v4.6.0 และเวอร์ชันที่ใหม่กว่า.
    • WeChat: ตรวจสอบผู้ใช้ด้วยบัญชี WeChat ซึ่งเปิดเผยหาก IP ของผู้ใช้อยู่ในจีนหรือภาษาของเกมเป็นภาษาจีนแบบย่อ. ใช้งานได้กับ Hive SDK v4.6.0 และเวอร์ชันที่ใหม่กว่า.
    • Apple: ตรวจสอบผู้ใช้ด้วยบัญชี Apple ซึ่งเปิดเผยบน iOS 13. ใช้งานได้กับ Hive SDK v4.11.7.3 และเวอร์ชันที่ใหม่กว่า.
    • SignInWithApple: การตรวจสอบผู้ใช้ด้วยบัญชี Apple บน Android รองรับบน Android API 21 และเวอร์ชันที่ใหม่กว่า. ใช้งานได้กับ Hive SDK v4.15.6 และเวอร์ชันที่ใหม่กว่า.
    • LINE: ตรวจสอบผู้ใช้ด้วยบัญชี LINE ซึ่งเปิดเผยบน iOS 10, และ Android SDK 17. ใช้งานได้กับ 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 ใด ๆ.