หน้านี้แสดงประวัติการแก้ไขเอกสารต่อไปนี้
- ข้อกำหนดด้านการช่วยเหลือพิเศษ
- หลักเกณฑ์การออกแบบเกมสำหรับฟีเจอร์เล่นเกม
- SDK สำหรับฟีเจอร์เล่นเกม
- ข้อกำหนดทางเทคนิค
- ข้อกำหนดด้านความปลอดภัยและความน่าเชื่อถือ
25 สิงหาคม 2026
- อัปเดตข้อกำหนดด้านความปลอดภัยและความน่าเชื่อถือ เพื่อเพิ่มนโยบายเนื้อหาที่ซ้ำกัน (ส่วนที่ 2.2) ซึ่งกำหนดให้ต้องมีเนื้อหาต้นฉบับที่ได้รับอนุญาต หรือได้รับใบอนุญาต และห้ามใช้บิลด์เกมที่ซ้ำกัน
24 สิงหาคม 2026
- เพิ่มแท็กการช่วยเหลือพิเศษของเกม (ส่วนที่ 2 และ 2.1) ซึ่งครอบคลุมการค้นพบเกมโดยผู้เล่นในโครงการ Accessible Gaming Initiative (AGI) และ ความถูกต้องของข้อมูลเมตาของนักพัฒนาแอป
11 กรกฎาคม 2024
- ปรับโครงสร้างข้อกำหนดทางเทคนิคเป็นหลายหน้า
- ล้างและนำข้อกำหนดที่ซ้ำกันออก
24 มิถุนายน 2024
เพิ่มขีดจำกัดขนาดรวมของบันเดิลจาก 100 MiB เป็น 250 MiB และเพิ่มคำแนะนำเกี่ยวกับการโหลดแบบ Lazy Loading
17 มิถุนายน 2024
ข้อมูลอัปเดตของชุดทดสอบ
- เกมไม่จำเป็นต้องแสดงผ่าน HTTPS อีกต่อไป และสามารถแสดงจาก localhost เพื่อทำการทดสอบได้
- เพิ่มปุ่มรีเฟรชข้างช่อง URL เพื่อรีเฟรชเนื้อหาของ iframe โดยไม่ต้องโหลดชุดทดสอบทั้งหมดซ้ำ
16 พฤษภาคม 2024
ย้ายแนวทางปฏิบัติแนะนำสำหรับการออกแบบไปยังเอกสารแยกต่างหากเพื่อแยกข้อกำหนดด้านการออกแบบและแนวทางปฏิบัติแนะนำให้ชัดเจนยิ่งขึ้น
8 พฤษภาคม 2024
ปรับโครงสร้างเว็บไซต์สำหรับนักพัฒนาแอปสำหรับฟีเจอร์เล่นเกมเพื่อขยายการเข้าถึงและปรับปรุงการนำทาง
7 พฤษภาคม 2024
อัปเดต ข้อกำหนดทางเทคนิค สำหรับ การแจ้งเตือนว่าเกมพร้อมแล้ว ด้วย
รายละเอียดเพิ่มเติมสำหรับการเรียก firstFrameReady
3 พฤษภาคม 2024
- สร้างเวอร์ชันเก็บถาวรของข้อกำหนดก่อนหน้า
5 มีนาคม 2024
เพิ่มขีดจำกัดขนาดไฟล์แต่ละไฟล์จาก 10 MiB เป็น 30 MiB
23 กุมภาพันธ์ 2024
เพิ่มบูลีน IN_PLAYABLES_ENV ลงในเนมสเปซระดับบนสุดเพื่อแจ้งให้นักพัฒนาแอปทราบเมื่อเกมของตนทำงานในสภาพแวดล้อมของฟีเจอร์เล่นเกม
4 ธันวาคม 2023
ข้อมูลอัปเดตของชุดทดสอบ
- เพิ่มการตรวจสอบอักขระที่ไม่รองรับในชื่อไฟล์
- ดูข้อมูลเกี่ยวกับอักขระที่รองรับได้ที่ข้อกำหนดทางเทคนิค - 1.9 ชื่อไฟล์
- ข้อจำกัดที่ทราบ: การตรวจสอบนี้อาจไม่ตรวจสอบทรัพยากรที่โหลดทั้งหมด
- เพิ่มฟีเจอร์เพื่อจำลองหน้าจอการโหลด รวมถึงการตั้งค่าความสูงเริ่มต้นของ iframe เป็น 0
- อัปเดตปุ่มหยุดชั่วคราว/เล่นต่อให้ตรงกับการทำงานจริงมากขึ้นด้วยการสลับเสียงเมื่อหยุดชั่วคราวและเล่นต่อ
- นำข้อความที่ไม่สามารถดำเนินการได้ออกจากการบันทึกเหตุการณ์
10 พฤศจิกายน 2023
เราได้แทนที่บันเดิลชุดทดสอบที่ดาวน์โหลดได้ด้วยชุดทดสอบที่โฮสต์ Test Suite
ไฟล์คำจำกัดความประเภท TypeScript ซึ่งก่อนหน้านี้มีอยู่ในบันเดิลชุดทดสอบ ได้ย้ายไปอยู่ในบทความหลักของ SDK สำหรับฟีเจอร์เล่นเกม แล้ว
7 กันยายน 2023
ส่วนเริ่มต้นใช้งานได้รับการอัปเดตเพื่อเปลี่ยน URL ของ SDK สำหรับฟีเจอร์เล่นเกม
จาก v0 เป็น v1
30 สิงหาคม 2023
ส่วนชื่อไฟล์และภาพปกได้รับการ
อัปเดตเพื่อนำการอ้างอิงที่ระบุรายการอักขระพิเศษที่อนุญาต
(_, -, .) ออก
นอกจากนี้ ส่วนการบันทึกในระบบคลาวด์ได้รับการอัปเดตให้กำหนดให้ การบันทึกในระบบคลาวด์ต้องทำงานในเกมเวอร์ชันใหม่
25 สิงหาคม 2023
ส่วน saveData ได้รับการอัปเดตเพื่อชี้แจงว่าข้อมูลที่บันทึก ต้องเป็นสตริง UTF-16 ที่ถูกต้องและมีรูปแบบที่ถูกต้อง
18 สิงหาคม 2023
ส่วนหยุดชั่วคราวและเล่นต่อได้รับการอัปเดตเพื่อชี้แจงว่า
เกมต้องหยุดการดำเนินการทั้งหมดหลังจากเรียก onPause และจะเล่นต่อเมื่อเรียก
onResume แล้วเท่านั้น
11 สิงหาคม 2023
ส่วนชื่อไฟล์ได้รับการเพิ่มเพื่อรวมข้อจำกัดด้านอักขระ ที่ใช้ในการตั้งชื่อไฟล์ในบันเดิลเกม
10 สิงหาคม 2023
ส่วนวิธีการโต้ตอบได้รับการอัปเดตให้กำหนดให้คอมโพเนนต์ UI ทั้งหมด ของเกมต้องทำงานตามที่ตั้งใจไว้และไม่มีข้อผิดพลาดหรือ ลักษณะการทำงานที่ไม่คาดคิด
9 สิงหาคม 2023
ส่วนรูปภาพปกได้รับการเพิ่มเพื่อแสดงข้อกำหนดของ ภาพปกของเกม ซึ่งจะช่วยให้ผู้ใช้ค้นพบและจดจำ ฟีเจอร์เล่นเกมใน YouTube ได้อย่างง่ายดาย
8 สิงหาคม 2023
ส่วนท่าทางสัมผัสและการป้อนข้อมูลได้รับการอัปเดตเพื่อห้ามไม่ให้
เกมเรียก preventDefault() ในเหตุการณ์ Esc
นอกจากนี้ เรายังได้เพิ่มส่วน การอ้างอิงไฟล์ ใหม่เพื่อกำหนดให้ เกมใช้เฉพาะเส้นทางแบบสัมพัทธ์เมื่ออ้างอิงไฟล์อื่นๆ ในบันเดิล เนื่องจาก เส้นทางแบบสัมบูรณ์อาจทำให้เกิดข้อผิดพลาด
2 สิงหาคม 2023
ส่วนปิดเสียงของทั้ง ข้อกำหนดทางเทคนิค และ หลักเกณฑ์การออกแบบเกมสำหรับฟีเจอร์เล่นเกมได้รับการอัปเดตเพื่ออ้างอิงฟีเจอร์ปิดเสียงและเปิดเสียงเป็น ส่วนควบคุมเสียง และระบุว่าส่วนควบคุมเสียงแบบละเอียดอาจมี แถบเลื่อนระดับเสียงหรือปุ่มเปิด/ปิดเสียง หรือทั้ง 2 อย่าง
28 กรกฎาคม 2023
เอกสารหลักเกณฑ์การออกแบบเกมสำหรับฟีเจอร์เล่นเกมได้รับการอัปเดตเพื่อ กำหนดคำศัพท์ให้เป็นมาตรฐาน รวมถึงอัปเดตแนวทางปฏิบัติแนะนำและภาพหน้าจอ
20 กรกฎาคม 2023
ส่วนหยุดชั่วคราวและเล่นต่อได้รับการเพิ่มเพื่อมอบ ความสามารถในการหยุดชั่วคราวและเล่นต่อข้ามแพลตฟอร์ม
19 กรกฎาคม 2023
ตอนนี้เว็บไซต์ YouTube Playables มีเอกสารหลักเกณฑ์การออกแบบเกมสำหรับฟีเจอร์เล่นเกม เพื่อใช้เป็นแนวทางในการมอบประสบการณ์การเล่นเกมที่เหมาะสมที่สุดแก่ ผู้ใช้ที่เล่นเกม YouTube ในอุปกรณ์และแพลตฟอร์มต่างๆ
หลักเกณฑ์การออกแบบเกมมุ่งเน้นที่ส่วนต่อไปนี้
- รูปภาพปก
- การปรับให้เหมาะกับอุปกรณ์
- อินเทอร์เฟซผู้ใช้ (UI)
- ท่าทางสัมผัสและการป้อนข้อมูล
- หยุดชั่วคราว
- ปิดเสียง
- การตอบสนองแบบรู้สึกได้
- การเริ่มต้นใช้งานของผู้ใช้
- การแข่งขันจบแล้ว (หน้าจอแสดงผลการชนะ)
- การช่วยเหลือพิเศษ
นอกจากนี้ ส่วน onAudioEnabledChange ได้รับการอัปเดตเพื่อแก้ไขข้อผิดพลาดเล็กน้อย
ในการพิมพ์ในโค้ด ซึ่งทำให้เกิดข้อผิดพลาดในเลเยอร์การทำงานร่วมกันของ JavaScript (JS-Interop) ที่เสนอโดย Flutter
14 กรกฎาคม 2023
ส่วนขนาดได้รับการอัปเดตดังนี้
- นำข้อกำหนดที่ว่าเกมต้องเล่นได้แบบเต็มหน้าจอบนเดสก์ท็อปและในแนวนอนหรือแนวตั้งบนอุปกรณ์เคลื่อนที่ออก
- เพิ่มข้อกำหนดที่ว่าเกมต้องเล่นได้ในแนวตั้ง
- เพิ่มข้อกำหนดที่ว่าเกมควรเล่นได้ในแนวนอน มิฉะนั้นเกมต้องอยู่ตรงกลางหรือต้องมี Pillarbox
- เพิ่มข้อกำหนดที่ว่าเกมต้องไม่ล็อกการวางแนวของอุปกรณ์
11 กรกฎาคม 2023
ส่วน Flutter Web (เวอร์ชันทดลอง) ได้รับการเพิ่มเพื่อเปิดใช้ การผสานรวมกับเกมที่เขียนด้วย Flutter Web
1 กรกฎาคม 2023
ส่วนปุ่มเปิด/ปิดเสียงกำหนดให้เกมต้องปฏิบัติตามการตั้งค่าเสียงของทั้ง YouTube และระบบ และเสียงของเกมต้องไม่เล่นโดยไม่คาดคิด
นอกจากนี้ ส่วนการจัดการเนื้อหาให้เสร็จสมบูรณ์ ยังชี้แจงว่าเกมต้องแจ้งให้ผู้ใช้ทราบว่าไม่มี เนื้อหาให้โต้ตอบอีกต่อไป เช่น ในระดับสุดท้ายหรือเมื่อเล่นเกมจบแล้ว
30 มิถุนายน 2023
ตอนนี้ส่วนเริ่มต้นใช้งานมีหมายเหตุว่า SDK จะไม่ดำเนินการใดๆ เมื่อมีการแสดงเกมในเครื่อง หากต้องการยืนยันความถูกต้องของการผสานรวม SDK โปรดดูชุดทดสอบ SDK
2 มิถุนายน 2023
ตอนนี้เว็บไซต์ YouTube Playables มีเอกสารประกอบเกี่ยวกับ Playables SDK สำหรับฟีเจอร์เล่นเกม ซึ่ง มีชุด API ที่มีประสิทธิภาพเพื่อรองรับเกม YouTube
26 พฤษภาคม 2023
ข้อมูลอัปเดตเอกสารประกอบเกี่ยวกับข้อกำหนดทางเทคนิคมีดังนี้
| ส่วน | การเปลี่ยนแปลง |
|---|---|
| เวลาที่ใช้ในการโหลด | รวมความเร็วอินเทอร์เน็ตเฉลี่ยทั่วโลกที่ 6.8 Mbps และ 20 Mbps สำหรับ สหรัฐอเมริกา |
| วิธีการโต้ตอบ | เพิ่มข้อกำหนดที่ว่าเมื่อผู้ใช้โต้ตอบกับเกม เกมต้องไม่ หน่วงเวลาหรือละเลยการป้อนข้อมูลโดยไม่ตั้งใจ |
| ภาพปก | อัปเดตความละเอียดของรูปภาพที่กำหนดสำหรับอัตราส่วน 1:1, 5:7 และ 16:9 |
| ข้อมูลผู้เผยแพร่โฆษณาหรือนักพัฒนาแอป | เพิ่มส่วนใหม่นี้ที่กำหนดให้เกมต้องระบุชื่อผู้เผยแพร่โฆษณาหรือนักพัฒนาแอป และอาจต้องระบุการจัดประเภทเนื้อหา ในอนาคต |
| โหลด SDK สำหรับฟีเจอร์เล่นเกม | เพิ่มส่วนใหม่นี้ที่กำหนดให้เกมต้องโหลด SDK สำหรับฟีเจอร์เล่นเกม ก่อนโค้ดเกมอื่นๆ |
| การแจ้งเตือนว่าเกมพร้อมแล้ว | อัปเดตให้เรียก API firstFrameReady เมื่อเฟรมแรกของเกมพร้อมที่จะแสดงบนหน้าจอเท่านั้น และเรียก API gameReady เมื่อเกมพร้อมสำหรับการโต้ตอบของผู้ใช้เท่านั้น |
| ปุ่มเปิด/ปิดเสียง | เพิ่มข้อกำหนดที่ว่าเมื่อตั้งค่าปิดเสียงของ YouTube แล้ว จะต้องไม่มีการส่งออกเสียง และปุ่มควบคุมการปิดเสียงหรือเปิดเสียงของเกมต้องไม่ส่งผลต่อเอาต์พุตเสียง |
24 มีนาคม 2023
ตอนนี้เว็บไซต์ YouTube Playables มีเอกสารประกอบเกี่ยวกับข้อกำหนดทางเทคนิค โดยมีเป้าหมายเพื่อมอบประสบการณ์การเล่นเกมที่ราบรื่นแก่ผู้ใช้ ที่เล่นเกมบน YouTube
ส่วนข้อกำหนดทางเทคนิคมุ่งเน้นที่ส่วนต่อไปนี้
- ความเสถียรของเกม
- ประสบการณ์การใช้งาน YouTube
- การผสานรวม YouTube
- การแปล
- การสร้างรายได้