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

ส่วนนี้ครอบคลุมการผสานรวมระหว่างฟีเจอร์เล่นเกมกับ 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 เท่านั้น การดำเนินการรวมถึงความสามารถทั้งหมดที่เล่นได้ เช่น ลูปเกม เพลง การโต้ตอบ การเรียกเครือข่าย และการแสดงผล
  • เกมต้องไม่ใช้ Page Visibility API บนเว็บหรือ Web API ที่คล้ายกัน และต้องใช้เฉพาะ Playables SDK onPause และ onResume
  • เกมควรบันทึกความคืบหน้าของผู้ใช้เมื่อเกิด onPause