การป้อนคีย์ตาม IdP
ในการใช้ฟีเจอร์การตรวจสอบสิทธิ์ SDK ของ Hive คุณต้องใช้ค่าคีย์ที่จัดเตรียมโดยแต่ละ IdP (Identity Provider) ในทุกเครื่องมือพัฒนา เอกสารนี้จะชี้แนะแนวทางในการป้อนค่าคีย์ที่ออกจากแต่ละคอนโซล IdP ลงใน Hive console และไฟล์ hive_config.xml
ภาพรวม¶
ในการใช้ IdP ใด ๆ คุณต้องได้รับค่าคีย์ที่ออกจากคอนโซล IdP และป้อนลงในคอนโซล Hive หรือในไฟล์ hive_config.xml (หรือทั้งสองอย่าง) ตัวอย่างเช่น หากนักพัฒนาต้องการให้ผู้ใช้เข้าสู่ระบบด้วย Google และ Apple ในสภาพแวดล้อม Windows พวกเขาจะต้องได้รับค่าคีย์ที่ออกจากคอนโซล Google และคอนโซล Apple และป้อนคีย์ลงในทั้งคอนโซล Hive และไฟล์ hive_config.xml โปรดดูเนื้อหาต่อไปนี้สำหรับตำแหน่งในการป้อนค่าคีย์สำหรับแต่ละ IdP และ OS
- hive_config.xml
- ป้อนค่าคีย์ที่ได้รับจาก IdP console ที่คุณต้องการใช้ใน hive_config.xml file
- ในสภาพแวดล้อม Unity หรือ Unreal Engine สามารถป้อนได้ใน Config Editor
- Hive console
- ป้อนค่าคีย์ที่ได้รับจาก IdP console ที่คุณต้องการใช้ใน Hive console
- Hive console, hive_config.xml
- ค่าคีย์ต้องป้อนในทั้ง Hive console และ hive_config.xml
- การยกเว้นจากการตั้งค่า
- ไม่จำเป็นต้องป้อนค่าคีย์ในทั้ง Hive console และ hive_config.xml
- ไม่รองรับ
- IdP ที่ไม่รองรับ
| IdP / OS | Android | iOS | Windows | macOS | เข้าสู่ระบบผ่านเว็บ |
|---|---|---|---|---|---|
| เข้าสู่ระบบด้วย Google Play | Hive console, hive_config.xml | ไม่รองรับ | ไม่รองรับ | ไม่รองรับ | ไม่รองรับ |
| Hive เข้าสู่ระบบ | ยกเว้นการตั้งค่า | ยกเว้นการตั้งค่า | ยกเว้นการตั้งค่า | ยกเว้นการตั้งค่า | Hive console |
| เข้าสู่ระบบด้วย Facebook | hive_config.xml | hive_config.xml | Hive console, hive_config.xml | Hive console | Hive console |
| เข้าสู่ระบบเป็นแขก | ยกเว้นการตั้งค่า | ยกเว้นการตั้งค่า | ไม่รองรับ | ไม่รองรับ | ไม่รองรับ |
| เข้าสู่ระบบด้วย Apple | Hive console, hive_config.xml | hive_config.xml | Hive console, hive_config.xml | Hive console | Hive console |
| เข้าสู่ระบบด้วย Google | hive_config.xml | hive_config.xml | Hive console, hive_config.xml | Hive console | Hive console |
| เข้าสู่ระบบด้วย QQ | hive_config.xml | hive_config.xml | ไม่รองรับ | ไม่รองรับ | ไม่รองรับ |
| เข้าสู่ระบบด้วย VK | hive_config.xml | hive_config.xml | ไม่รองรับ | ไม่รองรับ | ไม่รองรับ |
| เข้าสู่ระบบด้วย WeChat | hive_config.xml | hive_config.xml | ไม่รองรับ | ไม่รองรับ | ไม่รองรับ |
| เข้าสู่ระบบด้วย LINE | hive_config.xml | hive_config.xml | hive_config.xml | ไม่รองรับ | ไม่รองรับ |
| เข้าสู่ระบบด้วย Weverse | hive_config.xml | hive_config.xml | ไม่รองรับ | ไม่รองรับ | ไม่รองรับ |
| เข้าสู่ระบบด้วย HUAWEI ID | Hive console | ไม่รองรับ | ไม่รองรับ | ไม่รองรับ | ไม่รองรับ |
| เข้าสู่ระบบด้วย Steam | Hive console, hive_config.xml | Hive console, hive_config.xml | Hive console, hive_config.xml | Hive console | ไม่รองรับ |
| เข้าสู่ระบบด้วย X | hive_config.xml | hive_config.xml | hive_config.xml | ไม่รองรับ | ไม่รองรับ |
| เข้าสู่ระบบด้วย Telegram | Hive console, hive_config.xml | Hive console, hive_config.xml | hive_config.xml | ไม่รองรับ | ไม่รองรับ |
Hive การป้อนในคอนโซล¶
เมื่อให้ฟีเจอร์การเข้าสู่ระบบในเกม คุณต้องกำหนด IdP ที่จะเปิดเผยและลำดับการเปิดเผย เพื่อทำเช่นนี้ ให้ดำเนินการตามลำดับด้วย Hive คอนโซลเพื่อ เลือกประเภทการเข้าสู่ระบบ เปลี่ยนลำดับการเข้าสู่ระบบ และลงทะเบียนคีย์การตรวจสอบสิทธิ์ในคอนโซล Hive。
การออกกุญแจความปลอดภัย¶
เพื่อเพิ่มความปลอดภัยในการตรวจสอบสิทธิ์ระหว่างบริการ คุณต้องขอรับ กุญแจความปลอดภัย จาก Hive console > การตั้งค่ากุญแจความปลอดภัย.
Warning
หากคุณไม่ได้รับคีย์ความปลอดภัย ผู้ใช้แอปจะไม่สามารถเข้าสู่ระบบแอปได้.
ข้อมูลสำหรับ hive_config.xml¶
รับค่าคีย์จากคอนโซล IdP และป้อนลงในไฟล์ hive_config.xml ตัวอย่างต่อไปนี้เป็นโค้ดที่สมมติว่ามีการใช้ IdP ทั้งหมด
<properties>
<providers>
<!-- เข้าสู่ระบบด้วย Google Play (Google Play Games) -->
<googleplaygames playAppId="123456789012" serverClientId="123456789012-abc.apps.googleusercontent.com" />
<!-- ลงชื่อเข้าใช้ด้วย Facebook (Facebook) -->
<!-- โค้ด Facebook ต่อไปนี้เป็นตัวอย่างวิธีการตั้งค่าการอนุญาตเพิ่มเติม (เช่น user_friends, user_gender) นอกเหนือจากการอนุญาต email และ public_profile ที่ถูกตั้งค่าโดยอัตโนมัติโดย Hive SDK. -->
<!-- เมื่อใช้ hive_config.xml ควรใส่เฉพาะการอนุญาตที่จำเป็นโดยบริษัทเกมลงใน <permission> element. -->
<facebook>
<permissions>
<permission name="user_friends" />
<permission name="user_gender" />
</permissions>
</facebook>
<!-- Sign in with Apple -->
<signinwithapple serviceid="com.sample.your" />
<!-- ลงชื่อเข้าใช้ด้วย Google (Google Sign-In) -->
<google playAppId="123456789012" serverClientId="123456789012-abc.apps.googleusercontent.com" />
<!-- ลงชื่อเข้าใช้ด้วย QQ -->
<qq id="1234567890" />
<!-- เข้าสู่ระบบด้วย WeChat -->
<wechat id="wx12345cf6c789c0f1" secret="abcdefg" />
<!-- LINE login -->
<line channelId="1234567890" />
<!-- ล็อกอินด้วย Weverse -->
<weverse clientId="abcdefg" />
<!-- Log in with Steam -->
<steam realm="https://your-app.com"/>
<!-- เข้าสู่ระบบด้วย X -->
<x clientId="ABCDEFG"/>
<!-- ลงชื่อเข้าใช้ด้วย Telegram (Telegram) -->
<telegram botId="123456789" botDomain="https://auth.qpyou.cn"/>
</providers>
</properties>
<properties>
<providers>
<!-- เข้าสู่ระบบด้วย Facebook (Facebook) -->
<!-- โค้ด Facebook ด้านล่างเป็นตัวอย่างวิธีการตั้งค่าการอนุญาตเพิ่มเติม (เช่น user_friends, user_gender) นอกเหนือจากการอนุญาต email และ public_profile ที่กำหนดค่าโดยอัตโนมัติด้วย Hive SDK. -->
<!-- เมื่อใช้งานจริง hive_config.xml ควรใส่เฉพาะการอนุญาตที่จำเป็นสำหรับบริษัทเกมลงใน <permission> เท่านั้น. -->
<facebook>
<permissions>
<permission name="user_friends" />
<permission name="user_gender" />
</permissions>
</facebook>
<!-- ลงชื่อเข้าใช้ด้วย Apple -->
<signinwithapple serviceid="com.sample.your" />
<!-- ลงชื่อเข้าใช้ด้วย Google (Google Sign-In) -->
<google serverClientId="123456789012-abc.apps.googleusercontent.com" reversedClientId="com.googleusercontent.apps.123456789012-abc" />
<!-- Log in with QQ -->
<qq id="1234567890" />
<!-- ล็อกอินด้วย VK -->
<vk appId="1234567" />
<!-- เข้าสู่ระบบด้วย WeChat -->
<wechat id="wx12345cf6c789c0f1" secret="abcdefg" />
<!-- เข้าสู่ระบบด้วย LINE -->
<line channelId="1234567890" />
<!-- ล็อกอินด้วย Weverse -->
<weverse clientId="abcdefg" />
<!-- ล็อกอินด้วย Steam -->
<steam realm="https://your-app.com"/>
<!-- ลงชื่อเข้าใช้ด้วย X -->
<x clientId="ABCDEFG"/>
<!-- เข้าสู่ระบบด้วย Telegram -->
<telegram botId="123456789" botDomain="https://auth.qpyou.cn"/>
</providers>
</properties>
``` xml
<providers>
<!-- เข้าสู่ระบบด้วย Facebook (Facebook) -->
<!-- โค้ด Facebook ด้านล่างเป็นตัวอย่างของวิธีการตั้งค่าการอนุญาตเพิ่มเติม (เช่น user_friends, user_gender) นอกเหนือจากการอนุญาต email และ public_profile ที่ตั้งค่าโดยอัตโนมัติด้วย Hive SDK. -->
<!-- เมื่อใช้ hive_config.xml บริษัทเกมควรใส่เฉพาะการอนุญาตที่จำเป็นลงใน <permission> element. -->
<facebook id="1809615065921877">
<permissions>
<permission name="user_friends" />
<permission name="user_gender" />
</permissions>
</facebook>
<!-- ลงชื่อเข้าใช้ด้วย Apple -->
<signinwithapple serviceid="com.sample.your" />
null null null null ```
null null null null null null null
Playappid (Android)¶
ตั้งค่า ID ลูกค้าประเภท Android ที่ออกโดย Google Cloud Console.
รหัสลูกค้าเซิร์ฟเวอร์ (Android)¶
ตั้งค่า Web Application Client ID ที่ได้รับจาก Google Cloud Console.
ในการใช้ค่าของ serverClientId ตามที่เป็นอยู่ คุณต้องลงทะเบียน authorized redirect URI ใน web application client ID สำหรับรายละเอียดเพิ่มเติม โปรดดูที่ การตั้งค่า redirect URI เมื่อเชื่อมโยงการรับรองตัวตน IdP Google Play
เข้าสู่ระบบด้วย Facebook¶
โปรดดูตัวอย่างต่อไปนี้เพื่อป้อนค่าในแท็ก providers ของไฟล์ hive_config.xml
<properties>
<!-- Hive SDK common settings omitted -->
<!-- การตั้งค่าการตรวจสอบสิทธิ์ Hive SDK: เริ่มต้น -->
<providers>
<!-- เข้าสู่ระบบด้วย Facebook (Facebook) -->
<!-- โค้ด Facebook ด้านล่างเป็นตัวอย่างของวิธีการตั้งค่าการอนุญาตเพิ่มเติม (เช่น user_friends, user_gender) นอกเหนือจากการอนุญาต email และ public_profile ที่ถูกตั้งค่าโดยอัตโนมัติโดย Hive SDK. -->
<!-- เมื่อใช้ hive_config.xml จริง ๆ ควรแทรกเฉพาะการอนุญาตที่จำเป็นโดยบริษัทเกมเป็น <permission> elements. -->
<facebook>
<permissions>
<permission name="user_friends" />
<permission name="user_gender" />
</permissions>
</facebook>
</providers>
<!-- การตั้งค่าการตรวจสอบสิทธิ์ Hive SDK: สิ้นสุด -->
</properties>
<properties>
<!-- Hive SDK common settings omitted -->
<!-- การตั้งค่าการรับรองความถูกต้องของ Hive SDK: เริ่มต้น -->
<providers>
<!-- เข้าสู่ระบบด้วย Facebook (Facebook) -->
<!-- รหัส Facebook ต่อไปนี้เป็นตัวอย่างของวิธีการตั้งค่าการอนุญาตเพิ่มเติม (เช่น user_friends, user_gender) นอกเหนือจากการอนุญาต email และ public_profile ที่ตั้งค่าโดยอัตโนมัติจาก Hive SDK -->
<!-- เมื่อใช้ hive_config.xml ควรใส่เฉพาะการอนุญาตที่จำเป็นสำหรับบริษัทเกมเป็น <permission> elements เท่านั้น -->
<facebook id="1809615065921877">
<permissions>
<permission name="user_friends" />
<permission name="user_gender" />
</permissions>
</facebook>
</providers>
<!-- การตั้งค่าการรับรองความถูกต้องของ Hive SDK: สิ้นสุด -->
</properties>
ไอดี (วินโดว์)¶
Hive v4 นี่คือ ID แอปสำหรับใช้ฟีเจอร์การเข้าสู่ระบบ Facebook เมื่อใช้ Unity บน Windows คุณสามารถตรวจสอบ ID แอปได้ที่แดชบอร์ดแอป Meta หลังจากปรับเปลี่ยนการตั้งค่าแอป สามารถค้นหา ID แอปได้ที่นี่.
สิทธิ์ (android, ios, windows)¶
เมื่อใช้ Facebook SDK หากคุณต้องการสิทธิ์เพิ่มเติมนอกเหนือจากสิทธิ์อีเมลเริ่มต้น (การเข้าถึงที่อยู่อีเมลบัญชี Facebook) และ public_profile (การเข้าถึงโปรไฟล์สาธารณะของ Facebook) ที่ตั้งค่าโดย Hive คุณสามารถ ขอสิทธิ์ที่จำเป็นใน Facebook console และตั้งค่าสิทธิ์ในฟิลด์สิทธิ์ เมื่อเข้าสู่ระบบด้วย Facebook ที่ Hive คำขอเข้าสู่ระบบจะรวมถึงสิทธิ์ที่ตั้งค่าในฟิลด์สิทธิ์
ลงชื่อเข้าใช้ด้วย Apple¶
โปรดดูตัวอย่างต่อไปนี้เพื่อป้อนค่าในแท็ก providers ของไฟล์ hive_config.xml
รหัสบริการ (แอนดรอยด์, ไอโอเอส, วินโดวส์)¶
ตั้งค่าหมายเลขบริการ ที่ออกโดย Apple Developer Center เมื่อตั้งค่าเสร็จแล้ว คุณสามารถเข้าสู่ระบบด้วยบัญชี Apple ของคุณบน Android และ Windows.
ลงชื่อเข้าใช้ด้วย Google¶
โปรดดูตัวอย่างต่อไปนี้เพื่อป้อนค่าในแท็ก providers ของไฟล์ hive_config.xml
<properties>
<!-- Hive SDK common settings omitted -->
<!-- การตั้งค่าการตรวจสอบสิทธิ์ Hive SDK: เริ่มต้น -->
<providers>
<!-- ลงชื่อเข้าใช้ด้วย Google (Google Sign-In) -->
<google playAppId="123456789012" serverClientId="123456789012-abc.apps.googleusercontent.com" />
</providers>
<!-- การตั้งค่าการตรวจสอบสิทธิ์ Hive SDK: สิ้นสุด -->
</properties>
<properties>
<!-- Hive SDK common settings omitted -->
<!-- การตั้งค่าการรับรองความถูกต้องของ Hive SDK: เริ่มต้น -->
<providers>
<!-- เข้าสู่ระบบด้วย Google (Google Sign-In) -->
<google serverClientId="123456789012-abc.apps.googleusercontent.com" reversedClientId="com.googleusercontent.apps.123456789012-abc" />
</providers>
<!-- การตั้งค่าการรับรองความถูกต้องของ Hive SDK: สิ้นสุด -->
</properties>
<properties>
<!-- Hive SDK common settings omitted -->
<!-- การตั้งค่าการตรวจสอบสิทธิ์ Hive SDK: เริ่มต้น -->
<providers>
<!-- ลงชื่อเข้าใช้ด้วย Google (Google Sign-In) -->
<google serverClientId="123456789012-abc.apps.googleusercontent.com" deviceFlowClientId="331526026701-gn1abq1ev23nqj7rdvvlaamf7ii4f3u9.apps.googleusercontent.com" />
</providers>
<!-- การตั้งค่าการตรวจสอบสิทธิ์ Hive SDK: สิ้นสุด -->
</properties>
Playappid (android)¶
ตั้งค่า ID ลูกค้าประเภท Android ที่ออกโดย Google Cloud Console
รหัสเซิร์ฟเวอร์ไคลเอนต์ (แอนดรอยด์, ไอโอเอส, วินโดวส์)¶
ตั้งค่าหมายเลขประจำตัวของ เว็บแอปพลิเคชัน ที่ออกโดย Google Cloud Console.
รหัสลูกค้ากลับ (ios)¶
ตั้งค่า reverse client ID ที่ออกโดย Google Cloud console โปรดดูที่ เอกสารหน้า reverse client ID สำหรับ iOS Google Sign-In สำหรับข้อมูลเพิ่มเติม
Deviceflowclientid (windows)¶
ตั้งค่า Client ID ของประเภทลูกค้าที่ออกจาก Google Cloud Console.
ลงชื่อเข้าใช้ด้วย QQ¶
โปรดดูตัวอย่างต่อไปนี้เพื่อป้อนค่าในแท็ก providers ของไฟล์ hive_config.xml
ไอดี (แอนดรอยด์, ไอโอเอส)¶
ตั้งค่า QQ APP ID ที่ออกผ่าน Game App Registration Request for QQ Service (connect.qq.com) มีข้อกำหนดในการตรวจสอบเฉพาะที่ต้องขอโดยพลเมืองจีนเมื่อทำการลงทะเบียนแอป
เข้าสู่ระบบด้วย VK¶
โปรดดูตัวอย่างต่อไปนี้เพื่อป้อนค่าในแท็ก providers ของไฟล์ hive_config.xml
ไอดี (แอนดรอยด์, ไอโอเอส)¶
ตั้งค่า ID แอปพลิเคชัน VK ที่ออกโดยจาก หน้า VK service.
เข้าสู่ระบบด้วย WeChat¶
โปรดดูตัวอย่างต่อไปนี้เพื่อป้อนค่าในแท็ก providers ของไฟล์ hive_config.xml
รหัส (แอนดรอยด์, ไอโอเอส)¶
ตั้งค่าแอปเกม ID แอป APP ID ใน Wechat console.
ความลับ (แอนดรอยด์, ios)¶
ตั้งค่า AppSecret ที่สามารถตรวจสอบได้ใน Wechat console.
เข้าสู่ระบบด้วยไลน์¶
โปรดดูตัวอย่างต่อไปนี้เพื่อป้อนค่าในแท็ก providers ของไฟล์ hive_config.xml
channelId (Android, iOS, Windows)¶
ตั้งค่า Channel ID ที่สามารถตรวจสอบได้ในการตั้งค่าเบื้องต้นภายใต้ส่วน Providers ใน LINE Console.
เข้าสู่ระบบด้วย weverse¶
โปรดดูตัวอย่างต่อไปนี้เพื่อป้อนค่าในแท็ก providers ของไฟล์ hive_config.xml
Clientid (android, ios, windows)¶
ตั้งค่า Client ID ที่เป็นเอกลักษณ์สำหรับการเข้าสู่ระบบ Weverse สำหรับ Client ID ของ Weverse จะต้องออกผ่าน Weverse Contact
Istest (แอนดรอยด์, ไอโอเอส)¶
ตั้งค่าการเชื่อมต่อกับเซิร์ฟเวอร์ทดสอบ Weverse หรือไม่
true: เข้าถึงเซิร์ฟเวอร์ทดสอบ Weverse กรุณาใช้หลังจากพูดคุยกับตัวแทน Weverse ในระหว่างการพัฒนาfalse: เข้าถึงเซิร์ฟเวอร์การผลิต Weverse.
เข้าสู่ระบบด้วย Steam¶
โปรดดูตัวอย่างต่อไปนี้เพื่อป้อนค่าในแท็ก providers ของไฟล์ hive_config.xml
อาณาจักร (แอนดรอยด์, ไอโอเอส, วินโดว์)¶
ตั้งค่าชื่อโดเมนที่เป็นของทีมพัฒนาเกมให้ใช้เป็นข้อมูล realm ใน Steam OpenID authentication ป้อนโดเมนของบริการที่ขอการเข้าสู่ระบบ (เช่น https://your-app.com) ค่าที่ตั้งไว้จะถูกแสดงบนหน้าเข้าสู่ระบบของ Steam ด้วย ค่าเริ่มต้นคือ https://withhive.com คุณต้องป้อน โดเมนที่ถูกต้อง และหากไม่ถูกต้อง การเข้าสู่ระบบอาจไม่สามารถดำเนินการต่อได้
เข้าสู่ระบบด้วย x¶
โปรดดูตัวอย่างต่อไปนี้เพื่อป้อนค่าในแท็ก providers ของไฟล์ hive_config.xml
Clientid (แอนดรอยด์, ไอโอเอส, วินโดวส์)¶
ตั้งค่า OAuth 2.0 Client ID ของ X Console (X Developer Portal)。
เข้าสู่ระบบด้วยเทเลแกรม¶
โปรดดูตัวอย่างต่อไปนี้เพื่อป้อนค่าในแท็ก providers ของไฟล์ hive_config.xml
<properties>
<!-- Hive SDK common settings omitted -->
<!-- การตั้งค่าการตรวจสอบสิทธิ์ Hive SDK: เริ่มต้น -->
<providers>
<!-- เข้าสู่ระบบด้วย Telegram -->
<telegram botId="123456789" botDomain="https://auth.qpyou.cn"/>
</providers>
<!-- การตั้งค่าการตรวจสอบสิทธิ์ Hive SDK: สิ้นสุด -->
</properties>
บอทไอดี (แอนดรอยด์, ไอโอเอส, วินโดวส์)¶
ตั้งค่า botId สำหรับบริการเข้าสู่ระบบ Telegram เพื่อรับ botId ให้ดูที่ เอกสาร Telegram อย่างเป็นทางการ หรือ Hive การตั้งค่า Idp bot สำหรับการเข้าสู่ระบบ Telegram botId เป็นค่าที่จำเป็นเมื่อใช้การเข้าสู่ระบบ Telegram
โบตโดเมน (แอนดรอยด์, ไอโอเอส, วินโดว์)¶
ตั้งค่า botDomain สำหรับบริการเข้าสู่ระบบ Telegram เพื่อให้ได้ botDomain ให้ดูที่ เอกสารอย่างเป็นทางการของ Telegram หรือ Hive การตั้งค่า Idp bot สำหรับการเข้าสู่ระบบ Telegram หากคุณไม่ป้อน botDomain มันจะตั้งค่าเริ่มต้นเป็น https://auth.qpyou.cn ที่อยู่โดเมนนี้จะแสดงบนหน้าจอเข้าสู่ระบบ Telegram















