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

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

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

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

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

SDK จะทำงานแบบไม่มีการดำเนินการเมื่อเกมแสดงในเครื่อง หากต้องการยืนยันความถูกต้องในการผสานรวม 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

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

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