คู่มือการเชื่อมต่อ animate GO¶

animate Games Online รองรับการยืนยันตัวตนและการชำระเงินสำหรับการเผยแพร่บนสโตร์ในสภาพแวดล้อม Android

หากต้องการเชื่อมต่อ animate Games Online เข้ากับแอป ต้องทำสัญญาล่วงหน้า หลังจากทำสัญญาแล้ว ให้ดำเนินการตามคู่มือด้านล่าง

การเตรียมล่วงหน้า¶

1. ออกข้อมูลรับรองและตรวจสอบค่าคีย์¶

ตรวจสอบ Game ID, Client Secret และ clientId ใน เว็บไซต์ผู้พัฒนา animate GO

2. เตรียม App ID¶

ใน App Center > การจัดการ App ID > [App ID ใหม่] เลือก OS: Android และ Store: animate Games Online เพื่อสร้าง App ID
ตัวอย่าง App ID: com.[ชื่อบริษัท].[ชื่อโปรเจกต์].android.ago

3. ออก Security Key¶

เพื่อเสริมความปลอดภัยในการยืนยันตัวตนระหว่างบริการ ต้องออก Security Key ใน Hive Console > App Center > การตั้งค่า Security Key

4. ตั้งค่าคีย์ใน hive_config.xml¶

Note

การเข้าสู่ระบบ animate Games Online รองรับเฉพาะแพลตฟอร์ม Android เท่านั้น

หากต้องการใช้การเข้าสู่ระบบ animate Games Online ต้องออกค่าคีย์ที่จำเป็นจาก แดชบอร์ดผู้พัฒนา animate Games Online

โปรดดูตัวอย่างด้านล่าง แล้วป้อนค่าในแท็ก providers ของไฟล์ hive_config.xml

Android

<properties>
    <!-- Omit common Hive SDK settings -->

    <!-- Hive SDK authentication settings: START -->
    <providers>
        <!-- Login with animateGO -->
        <animatego clientId="YOUR_ANIMATEGO_CLIENT_ID"/>
    </providers>
    <!-- Hive SDK authentication settings: END -->
</properties>

clientId (Android)¶

ตั้งค่าตัวระบุไคลเอนต์เฉพาะ (clientId) สำหรับการเข้าสู่ระบบ animate Games Online ที่ออกจาก แดชบอร์ดผู้พัฒนา animate Games Online

5. เพิ่มไลบรารี AAR¶

ตั้งค่า dependency สำหรับโฟลเดอร์ libs ในไฟล์ build.gradle ระดับโมดูล

dependencies {
    implementation fileTree(include: ['*.aar'], dir: 'libs')
}

เพิ่มไลบรารีภายนอก (.aar) ที่รวมอยู่ในเวอร์ชันการแจกจ่าย SDK ไปยังโฟลเดอร์ libs ระดับโมดูล หากต้องการรองรับการเข้าสู่ระบบ IdP และ Billing ของ animate Games Online ต้องใช้ไฟล์ต่อไปนี้

sdk-XXXXXXXXXXXXXXXXXXXXXXX.aar
ตัวอย่าง: sdk-bf62685719935e68ec4100c0d51aa469.aar

6. ตั้งค่าการเข้าสู่ระบบ¶

ใน Hive Console > การยืนยันตัวตน > การตั้งค่าการเข้าสู่ระบบ ให้เลือก App ID ที่จะแสดง animate GO IdP แล้วป้อน Game ID และ Client Secret เพื่อตั้งค่าการเข้าสู่ระบบ

การใช้งานการเข้าสู่ระบบ animate GO¶

การเข้าสู่ระบบ animate Games Online ทำงานด้วยวิธี OAuth 2.0 Authorization Code + PKCE หากต้องการให้ callback การเข้าสู่ระบบทำงานตามปกติ ให้ลงทะเบียน Redirect URIs ของแอปใน แดชบอร์ดผู้พัฒนา animate Games Online

รูปแบบ Redirect URIs คือ <packageName>://store-login-callback ให้แทนที่ <packageName> ด้วยชื่อแพ็กเกจของแอป

ตัวอย่าง: com.com2us.hivesdk.android.ago://store-login-callback

จากนั้นให้นำไปใช้งานสำหรับ Android mobile โดยดู เข้าสู่ระบบ/ออกจากระบบ

การใช้งานการชำระเงิน animate GO¶

หากต้องการรับผลการชำระเงินจากสโตร์ animate Games Online ให้ลงทะเบียน Callback URLs ใน แดชบอร์ดผู้พัฒนา animate Games Online

ลงทะเบียน URL 4 รายการต่อไปนี้ในรายการ Callback URLs