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

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

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

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

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

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

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

Note

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

รายการ คำอธิบาย
ผู้ให้บริการ ระบุค่าคุณสมบัติสำหรับไลบรารีของบุคคลที่สาม
facebook องค์ประกอบที่เป็นขององค์ประกอบ ผู้ให้บริการ ที่กำหนดการตั้งค่าเกี่ยวกับ Facebook ที่ใช้สำหรับการตรวจสอบสิทธิ์กับ v4 หากต้องการสิทธิ์เพิ่มเติมนอกเหนือจากสิทธิ์อีเมลเริ่มต้น (การเข้าถึงที่อยู่อีเมลบัญชี Facebook) และ public_profile (การเข้าถึงโปรไฟล์สาธารณะของ Facebook) ที่ตั้งค่าโดย Hive SDK เมื่อใช้ Facebook SDK คุณต้อง ขอสิทธิ์เหล่านั้นในคอนโซล Facebook และเพิ่มเป็นองค์ประกอบใน hive_config.xml. เพื่อดำเนินการเข้าสู่ระบบ Facebook เมื่อใช้ Hive SDK v4 Unity Windows คุณต้องเพิ่มแอตทริบิวต์ id ภายในองค์ประกอบนี้และป้อน ID แอปเป็นค่าของแอตทริบิวต์ คุณสามารถ ค้นหา ID แอปในแดชบอร์ดแอป Meta หลังจากสร้างแอป.
google องค์ประกอบที่เป็นขององค์ประกอบ ผู้ให้บริการ ที่เพิ่มการตั้งค่าเกี่ยวกับ 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 ผู้ให้บริการ องค์ประกอบที่เพิ่มการตั้งค่าเกี่ยวกับ WeChat ที่ใช้สำหรับการตรวจสอบสิทธิ์กับ v4
qq ผู้ให้บริการ องค์ประกอบที่เพิ่มการตั้งค่าเกี่ยวกับ QQ ที่ใช้สำหรับการตรวจสอบสิทธิ์กับ v4
vk ผู้ให้บริการ องค์ประกอบที่เพิ่มการตั้งค่าเกี่ยวกับ VK ที่ใช้สำหรับการตรวจสอบสิทธิ์กับ v4
line ผู้ให้บริการ องค์ประกอบที่เพิ่มการตั้งค่าเกี่ยวกับ 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


การตั้งค่า IdP สำหรับการพิสูจน์ตัวตนในการเข้าสู่ระบบ Telegram

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

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

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