SDK Chơi game trên YouTube – Bắt đầu

YouTube Playables SDK là một SDK web để kết nối trò chơi trên web với môi trường YouTube. SDK này có một API mạnh mẽ để hỗ trợ trò chơi theo nhiều cách nhằm tạo ra trải nghiệm chơi trò chơi tuyệt vời trên YouTube.

Thêm Playables SDK vào trò chơi của bạn

Trò chơi phải có tệp index.html trong thư mục gốc. Nhập SDK Chơi game trên YouTube bằng cách thêm dòng này trước bất kỳ mã trò chơi nào:

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

SDK này sẽ chạy dưới dạng một thao tác không có tác dụng khi trò chơi của bạn được phân phát cục bộ. Để xác minh tính chính xác của quá trình tích hợp SDK, hãy sử dụng hướng dẫn về bộ kiểm thử.

Tích hợp với Playables SDK

Bạn cần tích hợp Playables SDK theo một số cách bắt buộc và không bắt buộc.

Yêu cầu về khả năng tích hợp

Xem lại các yêu cầu xuất bản tổng thể, tập trung vào các yêu cầu về khả năng tích hợp. Xem tài liệu tham khảo về Playables SDK để biết thông tin chi tiết về cách triển khai.

Ví dụ:

  • 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)

Ngoài các yêu cầu về khả năng tích hợp, bạn có thể sử dụng một số hàm khác để tạo ra trải nghiệm hấp dẫn. Ví dụ:

  • ytgame.system.getLanguage() – Sử dụng hàm này để truy xuất chế độ cài đặt ngôn ngữ hiện tại của người dùng. Đừng sử dụng các hàm khác hoặc lưu trữ ngôn ngữ trong bản lưu trên đám mây, vì ngôn ngữ có thể thay đổi bất cứ lúc nào.
  • ytgame.engagement.sendScore({ value: newScore }) – Gửi điểm số cao nhất lên YouTube để hiển thị.
  • ytgame.engagement.openYTContent({ id: videoID }) – Mở một video trên YouTube.
  • ytgame.health.logError() và ytgame.health.logWarning() – Ghi lại các vấn đề lên YouTube.
  • ytgame.ads.requestInterstitialAd() và requestRewardedAd(rewardId: string) – Tích hợp các tính năng quảng cáo vào trò chơi của bạn.

Xem tài liệu tham khảo về Playables SDK để biết thông tin chi tiết về cách triển khai và các hàm khác.

Định nghĩa loại TypeScript

Đối với các trò chơi sử dụng TypeScript, hãy tải định nghĩa loại xuống.

Trò chơi mẫu

Bạn có thể xem các mẫu minh hoạ cách tích hợp với YouTube Playables SDK, bao gồm JavaScript thuần tuý, Flutter web, Godot và Unity.

Kiểm thử trò chơi bằng bộ kiểm thử

Khi đã sẵn sàng, bạn có thể xác thực quá trình tích hợp bằng bộ kiểm thử. Để tìm hiểu cách thực hiện, hãy làm theo hướng dẫn về bộ kiểm thử.