ข้อกำหนดในการผสานรวม

ส่วนนี้ครอบคลุมการผสานรวมระหว่าง Playable กับ YouTube Playables SDK

1 โหลด Playables SDK

2 การแจ้งเตือนว่าเกมพร้อมแล้ว

  • เกมต้อง เรียกใช้ firstFrameReady เมื่อเกมแสดงหน้าจอโหลดหรือหน้าจอสแปลชที่สื่อสารกับผู้ใช้อย่างชัดเจน ว่ากระบวนการโหลดกำลังดำเนินการอยู่
  • เกมต้อง เรียกใช้ gameReady และต้อง เรียกใช้ gameReady ก็ต่อเมื่อ เกมพร้อมสำหรับการโต้ตอบของผู้ใช้ (เช่น เมนูหลักหรือเกมพร้อมเล่น)
  • เกมต้องไม่ เรียกใช้ gameReady ขณะที่ยังมีการแสดงองค์ประกอบที่ไม่สามารถโต้ตอบได้ แก่ผู้ใช้ (เช่น หน้าจอสแปลชหรือหน้าจอโหลด

YouTube จะไม่นำ "วงล้อโหลด" ออกจนกว่าจะมีการเรียกใช้ API นี้

3 คะแนนของผู้ใช้

  • เกมอาจ ใช้ sendScore เพื่อส่งคะแนนของผู้ใช้
  • หากเกมใช้ sendScore เพื่อส่งคะแนน เกมต้อง เป็นไปตาม ข้อกำหนด sendScore และต้อง ตรวจสอบว่าคะแนนสูงสุดที่ส่ง ตรงกับคะแนนสูงสุดในข้อมูลบันทึกของเกม

4 การบันทึกไว้ในระบบคลาวด์

  • เกมต้อง เรียกใช้ saveData เพื่อบันทึกความคืบหน้าเมื่อผู้ใช้มีความคืบหน้าในเกมอย่างเป็นรูปธรรม (เช่น เปลี่ยนระดับ) ซึ่งกลไกของเกมทำให้ผู้ใช้เชื่อว่าความคืบหน้าของตนได้รับการบันทึกแล้ว
  • เกมต้องไม่ ใช้กลไกอื่นใดในการบันทึกความคืบหน้าของผู้ใช้ ฟีเจอร์นี้ช่วยให้ผู้เล่นกลับมาเล่นเกมต่อได้ในภายหลัง
  • เกมต้อง รอ loadData ให้เสร็จสมบูรณ์ก่อนเรียกใช้ saveData หาก saveData ถูกเรียกใช้ก่อนที่ loadData จะเสร็จสมบูรณ์ ระบบจะปฏิเสธคำขอ ซึ่งจะป้องกันไม่ให้เกมเขียนทับข้อมูลที่บันทึกไว้ก่อนหน้านี้
  • เกมต้อง สามารถใช้ข้อมูลที่บันทึกไว้ในระบบคลาวด์จากเกมเวอร์ชันก่อนหน้าได้โดยไม่มีข้อผิดพลาดหรือการขัดข้อง
  • เกมควร ใช้ข้อมูลที่บันทึกไว้ในระบบคลาวด์เพื่อรักษาความคืบหน้าของผู้ใช้ในเกมทุกเวอร์ชันที่ผู้ใช้คาดหวังว่าจะมีการใช้ข้อมูลของตน
  • เกมควร บันทึกความคืบหน้าของผู้ใช้โดยอัตโนมัติเมื่อถึงเหตุการณ์สำคัญในเกมเพื่อป้องกันไม่ให้ข้อมูลสูญหาย ระบบจะทำการบันทึกข้อมูลครั้งสุดท้ายเมื่อผู้ใช้ ออกจากเกม แต่เป็นการดำเนินการอย่างเต็มความสามารถและบันทึกได้เฉพาะเนื้อหาที่มีความยาวไม่เกิน 64 KiB

5 เปิด/ปิดเสียง

  • เกมต้อง ปฏิบัติตามการตั้งค่าเสียงของระบบและปุ่มปิดเสียง
  • เกม ต้อง ปฏิบัติตามการตั้งค่าเสียงและปุ่มปิดเสียงของ YouTube โดยใช้ isAudioEnabled และ onAudioEnabledChange
  • เกมต้อง ปฏิบัติตามการควบคุมระดับเสียงในอุปกรณ์
  • เสียงของเกมต้องไม่ เล่นโดยไม่คาดคิด
  • เมื่อตั้งค่าปิดเสียง YouTube ไว้ ระบบต้องไม่ ส่งออกเสียง และการควบคุมเสียงของเกมต้องไม่ ส่งผลต่อเอาต์พุตเสียง
  • เมื่อไม่ได้ตั้งค่าปิดเสียง YouTube ไว้ การควบคุมเสียงของเกมอาจ ส่งผลต่อการส่งออกเสียง
  • เกมไม่ควร แสดงปุ่มปิดเสียงโดยรวมภายในเกมเอง แต่ควรให้ผู้ใช้ใช้ฟีเจอร์ระดับ YouTube สำหรับการดำเนินการนี้
  • เกมอาจ มีการควบคุมเสียงแบบละเอียดแยกต่างหากในเกม เช่น สำหรับเพลงและเอฟเฟกต์เสียง แต่การควบคุมเสียงเหล่านั้นต้อง เป็นไปตามข้อกำหนดอื่นๆ ทั้งหมดของการควบคุมเสียง

การตั้งค่าเสียงที่แตกต่างกันสำหรับพื้นหลัง เสียงเอฟเฟกต์ บทสนทนา

6 หยุดชั่วคราวและเล่นต่อ

Playables SDK มีการเรียกกลับสำหรับความสามารถในการหยุดชั่วคราวและเล่นต่อข้ามแพลตฟอร์ม

  • เกมต้อง หยุดการทำงานทั้งหมดหลังจากมีการเรียกใช้ onPause และต้อง กลับมาทำงานต่อเมื่อมีการเรียกใช้ onResume เท่านั้น การทำงานรวมถึงความสามารถทั้งหมดของ Playable เช่น ลูปของเกม เพลง การโต้ตอบ การเรียกใช้เครือข่าย และการแสดงผล
  • เกมต้องไม่ ใช้ Web Page Visibility API หรือ Web API ที่คล้ายกัน และ ต้อง ใช้ Playables SDK onPause และ onResume เท่านั้น
  • เกมควร บันทึกความคืบหน้าของผู้ใช้เมื่อเกิด onPause