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

ทุกเครื่องยนต์

นี่ให้คำแนะนำเกี่ยวกับการตั้งค่าที่จำเป็นที่ต้องใช้ในเครื่องมือพัฒนาทั้งหมดเพื่อใช้ฟีเจอร์การตรวจสอบสิทธิ์ SDK ของแบรนด์ Hive

Hive การตั้งค่าคอนโซล

ในการใช้การตรวจสอบสิทธิ์ Hive SDK คุณต้องกำหนดค่า การตั้งค่า IdP สำหรับแต่ละ AppID ในการตรวจสอบสิทธิ์ของ Hive คอนโซล

hive_config.xml การกำหนดค่า

hive_config.xml ไฟล์, เพิ่มการตั้งค่าการตรวจสอบสิทธิ์ตาม IdP ที่คุณต้องการใช้.

Note

สำหรับรายละเอียดเพิ่มเติมเกี่ยวกับการตั้งค่า hive_config.xml, โปรดดูที่ ต่อไปนี้.

รายการ คำอธิบาย
providers ระบุค่าคุณสมบัติสำหรับไลบรารีของบุคคลที่สาม
facebook องค์ประกอบที่เป็นขององค์ประกอบ providers ที่กำหนดการตั้งค่าเกี่ยวกับ Facebook ที่ใช้สำหรับการตรวจสอบสิทธิ์กับ v4 หากต้องการสิทธิ์เพิ่มเติมนอกเหนือจากสิทธิ์อีเมลเริ่มต้น (การเข้าถึงที่อยู่อีเมลบัญชี Facebook) และ public_profile (การเข้าถึงโปรไฟล์สาธารณะของ Facebook) ที่ตั้งโดย Hive SDK เมื่อใช้ Facebook SDK คุณต้อง ขอสิทธิ์เหล่านั้นใน Facebook console และเพิ่มเป็นองค์ประกอบใน hive_config.xml เพื่อดำเนินการเข้าสู่ระบบ Facebook เมื่อใช้ Hive SDK v4 Unity Windows คุณต้องเพิ่มแอตทริบิวต์ id ภายในองค์ประกอบนี้และป้อน ID แอปเป็นค่าของแอตทริบิวต์ คุณสามารถ ค้นหา ID แอปในแดชบอร์ด Meta app หลังจากสร้างแอป
google องค์ประกอบที่เป็นขององค์ประกอบ providers ที่เพิ่มการตั้งค่าเกี่ยวกับ Google ที่ใช้สำหรับการตรวจสอบสิทธิ์กับ v4 เพื่อดำเนินการเข้าสู่ระบบ Google บนเดสก์ท็อป คุณต้องเพิ่มแอตทริบิวต์ clientId ภายในองค์ประกอบนี้และป้อน Client ID ที่ออกจาก Google Cloud Console เป็นค่าของแอตทริบิวต์ เพื่อดำเนินการเข้าสู่ระบบ Google บน Steam Deck (Hive SDK v4 Unity Windows 22.0.0 หรือสูงกว่า) คุณต้องเพิ่มแอตทริบิวต์ deviceFlowClientId ภายในองค์ประกอบนี้และป้อน Client ID ที่ออกจาก Google Cloud Console เป็นค่าของแอตทริบิวต์
wechat providers องค์ประกอบที่เพิ่มการตั้งค่าเกี่ยวกับ WeChat ที่ใช้สำหรับการตรวจสอบสิทธิ์กับ v4
qq providers องค์ประกอบที่เพิ่มการตั้งค่าเกี่ยวกับ QQ ที่ใช้สำหรับการตรวจสอบสิทธิ์กับ v4
vk providers องค์ประกอบที่เพิ่มการตั้งค่าเกี่ยวกับ VK ที่ใช้สำหรับการตรวจสอบสิทธิ์กับ v4
line providers องค์ประกอบที่เพิ่มการตั้งค่าเกี่ยวกับ LINE ที่ใช้สำหรับการตรวจสอบสิทธิ์กับ v4
weverse providers องค์ประกอบที่เพิ่มการตั้งค่าเกี่ยวกับ Weverse ที่ใช้สำหรับการตรวจสอบสิทธิ์ด้วย v4.
signinwithapple องค์ประกอบที่เป็นของ providers ซึ่งเพิ่มการตั้งค่าเกี่ยวกับ Sign-in-with-Apple ที่ใช้สำหรับการตรวจสอบสิทธิ์ด้วย v4. (ใช้สำหรับการเข้าสู่ระบบด้วยบัญชี Apple บน Android และ Windows.) (+4.15.6) เพื่อดำเนินการเข้าสู่ระบบ Sign-in-with-Apple บน Android และ Windows คุณต้องเพิ่ม serviceid แอตทริบิวต์ภายในองค์ประกอบนี้และป้อน Services ID ที่ออกโดย Apple Developer Center เป็นค่าของแอตทริบิวต์.
steam องค์ประกอบนี้เป็นของ providers และเพิ่มการตั้งค่าเกี่ยวกับ Steam ที่ใช้สำหรับการตรวจสอบสิทธิ์ด้วย v4. (ใช้เมื่อเข้าสู่ระบบด้วยบัญชี Steam บน Android และ iOS.) เพื่อดำเนินการเข้าสู่ระบบ Steam บน Android และ iOS คุณต้องเพิ่ม realm แอตทริบิวต์ภายในองค์ประกอบนี้และป้อน Realm เป็นค่าของแอตทริบิวต์.
* ป้อนโดเมนของบริการที่ขอเข้าสู่ระบบ (เช่น https://your-app.com). ค่าที่ตั้งไว้จะถูกแสดงบนหน้าเข้าสู่ระบบ Steam ด้วย. (ค่าปริยาย: https://withhive.com)
* กรุณาป้อนโดเมนที่ถูกต้อง หากตั้งค่าโดเมนที่ไม่ถูกต้อง การร้องขอปกติอาจไม่ดำเนินการต่อ.
x องค์ประกอบนี้เป็นของ providers และเพิ่มการตั้งค่าเกี่ยวกับ X ที่ใช้สำหรับการตรวจสอบสิทธิ์ด้วย v4. คุณต้องเพิ่ม clientId แอตทริบิวต์ภายในองค์ประกอบนี้และป้อน OAuth 2.0 Client ID ของโครงการที่สร้างใน X Developer Portal เป็นค่าของแอตทริบิวต์.
telegram องค์ประกอบนี้เป็นของ providers และเพิ่มการตั้งค่าเกี่ยวกับ Telegram ที่ใช้เมื่อทำการตรวจสอบสิทธิ์ด้วย Authentication v4. เพิ่ม botId และ botDomain แอตทริบิวต์ภายในองค์ประกอบนี้. แต่ละแอตทริบิวต์คือ botId และ botDomain ของบอทที่สร้างขึ้นผ่าน Telegram's @BotFather. botId เป็นสิ่งจำเป็น และหาก botDomain ไม่ถูกตั้งค่า ค่าปริยายจะถูกตั้งเป็น 'https://auth.qpyou.cn'. ที่อยู่โดเมนนี้จะแสดงบนหน้าจอเข้าสู่ระบบ Telegram.
<properties>
    <providers>
        <!-- 아래 Facebook 코드는 Hive SDK에서 자동으로 설정하는 email 권한, public_profile 권한 외에 다른 권한들(예를 들면 user_friends, user_gender)이 추가로 필요할 때 이를 위해 설정하는 예시입니다.-->
        <!-- 실제로 hive_config.xml을 사용할 때에는, 게임사가 필요로 하는 권한만을 <permission> 요소로 삽입해야 합니다. -->
        <facebook id="1809615065921877">
            <permissions>
                <permission name="user_friends" />
                <permission name="user_gender" />
            </permissions>
        </facebook>

        <google playAppId="123456789012"  clientId="123456789012-abc.apps.googleusercontent.com"  serverClientId="123456789012-abc.apps.googleusercontent.com"  reversedClientId="com.googleusercontent.apps.123456789012-abc"  deviceFlowClientId="331526026701-gn1abq1ev23nqj7rdvvlaamf7ii4f3u9.apps.googleusercontent.com" />
        <googleplaygames playAppId="123456789012"  clientId="123456789012-abc.apps.googleusercontent.com"  serverClientId="123456789012-abc.apps.googleusercontent.com"  reversedClientId="com.googleusercontent.apps.123456789012-abc" />
        <qq id="1234567890" />
        <vk id="1234567" />      
        <wechat id="wx12345cf6c789c0f1" secret="abcdefg"  univeralLink="https://your.sample.com/"/>
        <line channelId="1234567890" />
        <weverse clientId="abcdefg" />
        <!-- (Android Only) 애플 개발자 계정에서 설정한 서비스 id를 serviceid로 설정 -->
        <signinwithapple serviceid="com.sample.your" />
        <!-- (Android&iOS) Steam 로그인 서비스 범위 설정. (기본 값: https://withhive.com) -->
        <steam realm="https://your-app.com"/>
        <x clientId="ABCDEFG"/>
                <telegram botId="123456789" botDomain="https://auth.qpyou.cn"/>
    </providers>
</properties>

การตั้งค่า Callback URI เมื่อรวม Idp X

เมื่อทำการรวมกับ X ในการพิสูจน์ตัวตน URI การตอบกลับที่ตั้งค่าใน X Developer Portal ต้องการรูปแบบที่กำหนดไว้ล่วงหน้าโดย Hive SDK ตามที่แสดงด้านล่าง

hive.x.{appId}://hive.providerx
ตัวอย่าง: hive.x.com.example.myapp://hive.providerx

URI การเรียกกลับนี้ถูกตั้งค่าใน การตั้งค่าการรับรองความถูกต้องของผู้ใช้ / ข้อมูลแอป ของโครงการที่สร้างใน X Developer Portal.

providerx_callbackuri_setting


การตรวจสอบสิทธิ์ การตั้งค่าบอทสำหรับการเข้าสู่ระบบ Telegram

ในการให้บริการเข้าสู่ระบบ Telegram ในการตรวจสอบสิทธิ์ จำเป็นต้องมีบอทเฉพาะ

สร้างบอทตามลำดับต่อไปนี้และรับ botId และ botDomain.\nสำหรับข้อมูลเพิ่มเติม โปรดดูที่ เอกสารอย่างเป็นทางการของ Telegram.

  1. ค้นหา '@BotFather' ใน Telegram และเข้าถึงห้องแชทที่มีเครื่องหมายการรับรองอย่างเป็นทางการ
  2. คลิกเริ่มที่ด้านล่างและป้อนคำสั่ง /newbot ในหน้าต่างแชท คุณสามารถรับโทเค็นการรับรองโดยการป้อน 'ชื่อ' และ 'ชื่อผู้ใช้' ตามคำแนะนำของ BotFather ในขณะนี้ ชื่อผู้ใช้ไม่สามารถเปลี่ยนแปลงได้ ดังนั้นคุณต้องป้อนอย่างระมัดระวัง หมายเลขก่อนเครื่องหมายสองจุด (':') ในสตริงโทเค็นที่ได้รับจะตรงกับ botId โทเค็นเป็นค่าที่ต้องป้อนใน Hive console ในภายหลัง ดังนั้นให้บันทึกไว้ด้วย
  3. ป้อนคำสั่ง /setDomain ในหน้าต่างแชท คุณสามารถตั้งค่าโดเมนที่จะแสดงบนหน้าจอเข้าสู่ระบบ ค่าอินพุตจะถูกใช้เป็น botDomain
  4. ป้อน botId และ botDomain ที่ได้รับใน hive_config.xml หากคุณใช้ Unity คุณสามารถเพิ่มได้อย่างง่ายดายโดยอ้างอิงจาก การตั้งค่า hive_config.xml