เริ่มต้นใช้งานบริการเกมของ Play สำหรับภาษา C++

ข้อควรระวัง: คู่มือนี้มีไว้สำหรับการใช้ Play Games บริการ v1 C SDK และคำแนะนำสำหรับบริการเกมของ Play เวอร์ชัน 2 จะพร้อมให้บริการเร็วๆ นี้ ในระหว่างนี้ คุณสามารถดูข้อมูลเพิ่มเติมเกี่ยวกับ v2 ได้ ในคู่มือการลงชื่อเข้าใช้ หากคุณสนใจทดลองใช้ SDK เวอร์ชันใหม่ โปรดติดต่อ ติดต่อขอข้อมูลเพิ่มเติมได้จากผู้ติดต่อของ Google

C++ SDK ของบริการเกมของ Google Play มี API สำหรับ C++ เพื่อใช้กับ Google Play Games และมีไว้สำหรับนักพัฒนาที่ใช้งาน C++ อยู่แล้ว ของเกม

ปัจจุบัน SDK ใช้บริการต่อไปนี้

• การให้สิทธิ์
• ความสำเร็จ
• ลีดเดอร์บอร์ด
• กิจกรรม
• เกมที่บันทึกไว้
• การเชื่อมต่อที่อยู่ใกล้เคียง (Android เท่านั้น)
• สถิติผู้เล่น

แนวคิด

คุณจะใช้ SDK ในระดับสูงได้โดยทำตามขั้นตอนต่อไปนี้

1. กำหนดค่าแพลตฟอร์มสำหรับ Android
2. ใช้ GameServices::Builder เพื่อกำหนดค่าและสร้าง GameServices ออบเจ็กต์ ออบเจ็กต์ GameServices จะพยายามลงชื่อเข้าใช้และส่งคืนโดยอัตโนมัติ ผลลัพธ์ผ่าน Callback OnAuthActionFinished() จดบันทึกผลลัพธ์ ที่แสดงผลโดยการเรียกกลับ หากการพยายามลงชื่อเข้าใช้โดยอัตโนมัติล้มเหลว คุณสามารถ แสดงปุ่มเพื่อให้ผู้ใช้ลงชื่อเข้าใช้ได้

3. หลังจากได้รับผลลัพธ์ OnAuthActionFinished() แล้ว คุณสามารถใช้ GameServices ออบเจ็กต์และผู้จัดการย่อยของออบเจ็กต์ดังกล่าวเพื่อเรียกบริการเกมของ Play ซึ่งรวมถึง

   • ลงชื่อเข้าใช้ (หลังจากให้สิทธิ์ไม่สำเร็จ): StartAuthorizationUI()
   • ปลดล็อกความสำเร็จ: Achievements().Unlock()
   • แสดงรางวัลพิเศษโดยใช้ UI ในตัว: Achievements().ShowAllUI()
   • ส่งคะแนนสูงสุด: Leaderboards().SubmitScore()
   • ออกจากระบบ: SignOut()

4. เมื่อใช้ออบเจ็กต์ GameServices เสร็จแล้ว ให้รีเซ็ตหรือทำลายรายการดังกล่าว

ในระดับที่ละเอียดกว่า

1. เริ่มต้นการกำหนดค่าแพลตฟอร์ม: เป็นออบเจ็กต์ที่มี ข้อมูลการเริ่มต้นเฉพาะแพลตฟอร์ม สำหรับ Android การกำหนดค่าแพลตฟอร์มจะประกอบด้วย Java VM และตัวชี้ไปยัง Activity ปัจจุบัน:

   // In android_main(), create a platform configuration
   // and bind the object activity.
   // Alternately, attach the activity in JNI_Onload().
   gpg::AndroidPlatformConfiguration platform_configuration;
   platform_configuration.SetActivity(state->activity->clazz);
   

2. สร้างออบเจ็กต์ GameServices: ออบเจ็กต์นี้เป็นจุดแรกเข้าหลักสำหรับ ฟังก์ชันการทำงานของบริการเกมของ Google Play สร้างอินสแตนซ์ GameServices รายการแล้ว ด้วย GameServices::Builder

   ในการใช้งานส่วนใหญ่ ออบเจ็กต์ GameServices ที่ระบุจะยังคงอยู่ตราบเท่าที่คุณ สิ่งที่สภาพแวดล้อม C ทำได้ คุณจะไม่ต้องเริ่มต้นใหม่เมื่อ Android Activity หยุดชั่วคราวและกลับมาทำงานอีกครั้ง

   // Creates a GameServices object that has lambda callbacks.
   game_services_ = gpg::GameServices::Builder()
           .SetDefaultOnLog(gpg::LogLevel::VERBOSE)
           .SetOnAuthActionStarted([started_callback](gpg::AuthOperation op) {
               is_auth_in_progress_ = true;
               started_callback(op);
           })
           .SetOnAuthActionFinished([finished_callback](gpg::AuthOperation op,
                                                        gpg::AuthStatus status) {
               LOGI("Sign in finished with a result of %d", status);
               is_auth_in_progress_ = false;
               finished_callback(op, status);
           })
           .Create(pc);
   

3. ใช้คลาส Manager เพื่อจัดการออบเจ็กต์ GameServices มีการเข้าถึงผู้จัดการจากฟังก์ชันที่เกี่ยวข้องกับอินสแตนซ์และกลุ่ม GameServices ตัวอย่างของรายการเหล่านี้ ได้แก่ ผู้จัดการความสำเร็จและลีดเดอร์บอร์ด บัญชีเหล่านี้ไม่มีรายการที่ผู้ใช้มองเห็น ระบุตนเอง ระบบจะแสดงผลผู้จัดการโดยการอ้างอิง และแท็กที่มี อินสแตนซ์ GameServices จะควบคุมวงจรการใช้งาน ลูกค้าไม่ควรถือสายรอ ไปยังการอ้างอิง "ผู้จัดการ" แต่ลูกค้าของคุณควรที่จะมี GameServices

   ผู้จัดการจะแสดงผลข้อมูลผ่านออบเจ็กต์ประเภทค่าที่เปลี่ยนแปลงไม่ได้ ค่าเหล่านี้ แสดงให้เห็นมุมมองที่สอดคล้องกันของข้อมูลที่สำคัญ ณ ช่วงเวลาเมื่อ ในการค้นหา

   // Submit a high score
   game_services_->Leaderboards().SubmitScore(leaderboard_id, score);
   
   // Show the default Achievements UI
   game_services_->Achievements().ShowAllUI();
   

4. เมื่อใช้ออบเจ็กต์ GameServices เสร็จแล้ว ให้ล้างตาม จะเรียก reset() ใน unique_ptr ที่เป็นเจ้าของ หรือโดยปล่อยให้ unique_ptr จะทำลายผลิตภัณฑ์ดังกล่าวโดยอัตโนมัติเมื่ออยู่นอกขอบเขต

โมเดลเทรด

หากไม่ได้ระบุไว้เป็นอย่างอื่น เมธอด GameServices และ Manager ทั้งหมดมี การติดตั้งใช้งานแบบอะซิงโครนัสที่ปลอดภัยต่อชุดข้อความ สามารถเรียกใช้ในชุดข้อความใดก็ได้ที่ไม่มี การล็อกภายนอก และจะดำเนินการตามลำดับที่สอดคล้องกับการเรียกใช้ คำสั่งซื้อ

เมธอด Accessor (วิธีที่อ่านสถานะ) มีรูปแบบหลักๆ 2 รูปแบบ องค์ประกอบ ประเภทของเมธอด (ที่มีชื่ออย่างเช่น FetchProperty()) จะให้ผลลัพธ์แบบไม่พร้อมกัน กับ Callback ที่มีให้ ตัวที่สอง (โดยใช้ชื่ออย่างเช่น FetchPropertyBlocking()) แสดงผลลัพธ์แบบพร้อมกันไปยังการเรียกใช้ ชุดข้อความ

// Blocking callback
gpg::AchievementManager::FetchAllResponse fetchResponse =
        game_services_->Achievements().FetchAllBlocking(std::chrono::milliseconds(1000));

// Non-blocking callback
game_services_->Achievements().FetchAll(gpg::DataSource::CACHE_OR_NETWORK,
    [] (gpg::AchievementManager::FetchAllResponse response) {
    LogI("Achievement response status: %d", response.status);});

ระบบจะเรียกใช้ Callback ของผู้ใช้ทั้งหมดในชุดข้อความ Callback เฉพาะ ชุดข้อความนี้ อาจแตกต่างจากแนวคิดแพลตฟอร์มของ "เทรดหลัก" หรือ "UI Thread" นอกจากนี้ คุณควรตรวจสอบว่าการเรียกกลับของผู้ใช้ทำงานได้อย่างรวดเร็ว ชุดข้อความ Callback ที่หยุดชะงัก อาจทำให้เกิดปัญหาที่ผู้ใช้มองเห็นได้ (เช่น การออกจากระบบล่าช้า คำขอ)

ข้อมูลจำเพาะของแพลตฟอร์ม

ในการเริ่มต้นใช้งาน Play Games C++ SDK บน Android ให้ไปที่ คู่มือเริ่มใช้งานฉบับย่อ

อ่านเพิ่มเติม

โปรดอ่านเอกสารประกอบสำหรับชั้นเรียนที่มาใน Google Play Games C++ SDK เพื่อดูรายละเอียดเพิ่มเติมและดู ตัวอย่างที่สาธิตวิธีใช้ SDK

หากเกมของคุณใช้เซิร์ฟเวอร์แบ็กเอนด์ ให้ดู การเปิดใช้การเข้าถึงบริการเกมของ Google Play ฝั่งเซิร์ฟเวอร์