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

ส่วนนี้ครอบคลุมการผสานรวมระหว่างฟีเจอร์เล่นเกมกับ YouTube SDK ของฟีเจอร์เล่นเกม

สำคัญ: ข้อกำหนดฉบับแปลมีไว้เพื่ออ้างอิงเท่านั้น โปรดดู ข้อกำหนดเวอร์ชันภาษาอังกฤษสำหรับคำแนะนำที่สมบูรณ์

SDK ฟีเจอร์เล่นเกมที่โหลด 1 รายการ

• เกมต้องโหลด SDK ฟีเจอร์เล่นเกมของ YouTube ไว้หน้าโค้ดเกม

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 หยุดชั่วคราวและทำต่อ

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

• เกมต้องหยุดการดำเนินการทั้งหมดชั่วคราวหลังจากเรียกใช้ onPause และต้อง ดำเนินการต่อเมื่อมีการเรียกใช้ onResume เท่านั้น การดำเนินการรวมทั้งหมด ความสามารถในการเล่น เช่น Game Loop, เพลง, การโต้ตอบ, เครือข่าย การโทร และการแสดงภาพ
• เกมต้องไม่ใช้ Page Monetization API หรือเว็บ API ที่คล้ายกัน และ ต้องใช้เฉพาะ SDK ฟีเจอร์เล่นเกม onPause และ onResume
• เกมควรบันทึกความคืบหน้าของผู้ใช้ในกรณีที่เกิด onPause