SDK ฟีเจอร์เล่นเกมของ YouTube - เริ่มต้นใช้งาน

YouTube Playables SDK เป็น Web SDK สำหรับเชื่อมต่อเกมบนเว็บกับสภาพแวดล้อมของ YouTube SDK มี API ที่มีประสิทธิภาพเพื่อรองรับเกมในหลากหลายวิธี ในการสร้างประสบการณ์การเล่นเกมที่ยอดเยี่ยมบน YouTube

เพิ่ม Playables SDK ลงในเกม

เกมควรมีไฟล์ index.html ในไดเรกทอรีราก นำเข้า YouTube Playables SDK โดยเพิ่มบรรทัดนี้ก่อนโค้ดเกม

<script src="https://www.youtube.com/game_api/v1"></script>

สำคัญ: ต้องโหลด SDK ก่อนโค้ดเกม ซึ่งจะสร้างสภาพแวดล้อมแบบแซนด์บ็อกซ์ที่ทำซ้ำได้และทำให้ฟังก์ชันบางอย่างพร้อมใช้งานกับเกมได้ทันที ระบบจะตรวจสอบความถูกต้องในระหว่างการเผยแพร่ และคุณสามารถทำตามคู่มือชุดทดสอบเพื่อตรวจสอบความถูกต้องก่อนส่งเกม

SDK จะทำงานเป็น no-op เมื่อเกมแสดงในเครื่อง หากต้องการยืนยันความถูกต้องของการผสานรวม SDK ให้ใช้คู่มือชุดทดสอบ

ผสานรวมกับ Playables SDK

การผสานรวมกับ Playables SDK มีทั้งแบบที่ต้องใช้และแบบที่ไม่ต้องใช้

การผสานรวมที่จำเป็น

อ่านข้อกำหนดในการเผยแพร่โดยรวม โดยเน้นที่ข้อกำหนดในการผสานรวม ดูรายละเอียดการติดตั้งใช้งานได้ที่ข้อมูลอ้างอิง Playables SDK

ตัวอย่างเช่น

• ytgame.game.firstFrameReady()
• ytgame.game.gameReady()
• ytgame.IN_PLAYABLES_ENV
• ytgame.system.isAudioEnabled()
• ytgame.system.onAudioEnabledChange((isAudioEnabled) => {})
• ytgame.system.onPause(() => {})
• ytgame.system.onResume(() => {})
• ytgame.game.loadData()
• ytgame.game.saveData(data)

การผสานรวมที่แนะนำ

นอกจากการผสานรวมที่จำเป็นแล้ว ยังมีฟังก์ชันอื่นๆ อีกหลายอย่าง เพื่อสร้างประสบการณ์การใช้งานที่น่าสนใจ ตัวอย่างเช่น

• ytgame.system.getLanguage() - ใช้เพื่อดึงการตั้งค่าภาษาปัจจุบันของ ผู้ใช้ อย่าใช้ฟังก์ชันอื่นๆ หรือจัดเก็บภาษาในระบบคลาวด์ บันทึก เนื่องจากอาจมีการเปลี่ยนแปลงได้ทุกเมื่อ
• ytgame.engagement.sendScore({ value: newScore }) - ส่งคะแนนที่ดีที่สุดไปยัง YouTube เพื่อแสดง
• ytgame.engagement.openYTContent({ id: videoID }) - เปิดวิดีโอ YouTube
• ytgame.health.logError() และ ytgame.health.logWarning() - รายงานปัญหาไปยัง YouTube

ดูรายละเอียดการติดตั้งใช้งานและฟังก์ชันเพิ่มเติมได้ในข้อมูลอ้างอิง Playables SDK

คำจำกัดความของประเภท TypeScript

สำหรับเกมที่ใช้ TypeScript ให้ดาวน์โหลดคำจำกัดความของประเภท

เกมตัวอย่าง

มีตัวอย่างที่แสดงวิธีผสานรวมกับ YouTube Playables SDK ซึ่งรวมถึง JavaScript ธรรมดา, Flutter Web, Godot และ Unity

ทดสอบเกมด้วยชุดทดสอบ

เมื่อพร้อมแล้ว คุณสามารถตรวจสอบการผสานรวมโดยใช้ชุดทดสอบได้ หากต้องการดูวิธี ให้ทำตามคู่มือชุดทดสอบ