เริ่มต้นใช้งาน

การเข้าสู่ระบบเว็บ API ภาพรวม¶

การเข้าสู่ระบบเว็บ API เป็น API ที่ให้การเชื่อมต่อ IdP (Identity Provider) บนหน้าเว็บ โดยการใช้งานการเข้าสู่ระบบด้วยการเข้าสู่ระบบเว็บ API ผู้ใช้สามารถเข้าสู่ระบบด้วย IdP ที่ต้องการ เช่น Google หรือ Facebook โดยตรงจากหน้าเว็บ การเข้าสู่ระบบเว็บโดยทั่วไปแนะนำให้ใช้สำหรับการเข้าสู่ระบบผู้ใช้ในเว็บไซต์ภายนอก (เช่น เว็บไซต์ชุมชนเกมที่ดำเนินการโดยนักพัฒนาแอปเกม) แทนที่จะเป็นในแอป มีสองเวอร์ชันของการเข้าสู่ระบบเว็บ API: v2 และ v1.

การเข้าสู่ระบบเว็บ V2¶

หากคุณได้พัฒนาแอปด้วย Hive SDK และต้องการให้ผู้ใช้แอปเข้าสู่ระบบในเว็บไซต์ภายนอก, เราขอแนะนำให้ใช้ Web Login V2 เมื่อผู้ใช้เข้าสู่ระบบในหน้าเว็บด้วย บัญชี IdP ของพวกเขา คุณสามารถรับ ตัวระบุ IdP (idp_user_id) ผ่าน Verification V2 API นักพัฒนาควรใช้ ตัวระบุ IdP นี้เป็นตัวระบุบัญชีสำหรับผู้ใช้เว็บไซต์ภายนอกและเก็บไว้ในฐานข้อมูลเว็บไซต์ภายนอก นี่เป็นเพราะคุณสามารถรับ PlayerID ซึ่งเป็นตัวระบุผู้ใช้ที่ใช้ในแอป โดยใช้ PlayerID Lookup API กับ ตัวระบุ IdP นี้ Web Login V2 ไม่ได้สร้าง PlayerID โดยตรง; คุณต้องรับ PlayerID ผ่าน ตัวระบุ IdP ในลักษณะนี้ นักพัฒนาสามารถรวมบัญชีผู้ใช้เดียวกันที่มีอยู่ในแอปกับบัญชีในเว็บไซต์ภายนอก

ตัวอย่างเช่น นักพัฒนาแอปเกมสามารถนำฟังก์ชันสำหรับผู้ใช้ไป เข้าสู่ระบบเว็บไซต์ชุมชนเกมของตนด้วยบัญชี Google โดยใช้ Web Login V2 หลังจากเข้าสู่ระบบแล้ว โดยการเรียกใช้ Verification V2 API คุณสามารถรับ IdP ตัวระบุของผู้ใช้ที่เข้าสู่ระบบด้วยบัญชี Google หากผู้ใช้คนเดียวกันเข้าสู่ระบบแอปเกม PlayerID ซึ่งเป็นตัวระบุผู้ใช้ในเกมจะถูกสร้างขึ้น คุณสามารถรับ PlayerID นี้ด้วย IdP ตัวระบุและ PlayerID Lookup API ดังนั้นนักพัฒนาจึงสามารถรวมบัญชีผู้ใช้เดียวกันที่มีอยู่ในทั้งชุมชนเกมและแอปเกมได้

การเข้าสู่ระบบเว็บ V1¶

หากคุณยังไม่ได้พัฒนาแอปของคุณด้วย Hive SDK และต้องการเข้าสู่ระบบผู้ใช้แอปในเว็บไซต์ภายนอก, เราขอแนะนำให้ใช้การเข้าสู่ระบบเว็บ V1 กล่าวอีกนัยหนึ่ง, การเข้าสู่ระบบเว็บ V1 เป็นที่แนะนำหากคุณต้องการใช้เฉพาะฟังก์ชันการเข้าสู่ระบบจากฟังก์ชันที่มีให้โดย Hive SDK นอกแอป เมื่อผู้ใช้เข้าสู่ระบบในหน้าเว็บด้วย บัญชี IdP ของพวกเขา, การเข้าสู่ระบบเว็บ V1 จะสร้าง PlayerID ของผู้ใช้ทันที (pid) นักพัฒนาสามารถระบุผู้ใช้ด้วย PlayerID และไม่มีความจำเป็นต้องได้รับหรือจัดการตัวระบุแยกต่างหากเช่น ตัวระบุ IdP

ตัวอย่างเช่น นักพัฒนาแอปเกมสามารถนำฟังก์ชันสำหรับผู้ใช้ในการเข้าสู่ระบบในชุมชนเกมของตนด้วยบัญชี Google โดยใช้ Web Login V1 เมื่อผู้ใช้เข้าสู่ระบบด้วยบัญชี Google PlayerID จะถูกสร้างขึ้นด้วย ดังนั้นนักพัฒนาแอปสามารถใช้ PlayerID นี้เพื่อตรวจสอบหรือใช้ข้อมูลผู้ใช้ใน Hive Console.