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

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

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

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

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

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
  • ytgame.ads.requestInterstitialAd() และ requestRewardedAd(rewardId: string) - ผสานรวมฟีเจอร์โฆษณาลงในเกม

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

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

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

เกมตัวอย่าง

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

ทดสอบเกมด้วยชุดโปรแกรมทดสอบ

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