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

SDK Chơi game trên YouTube là một SDK web để kết nối các 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

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 chạy dưới dạng no-op 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 việc tích hợp SDK, hãy sử dụng hướng dẫn về bộ thử nghiệm.

Tích hợp với Playables SDK

Có một số công cụ tích hợp bắt buộc và không bắt buộc với Playables SDK.

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

Xem xét các yêu cầu phát hành 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 công cụ tích hợp bắt buộc, còn có 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. Không sử dụng các hàm khác hoặc lưu trữ ngôn ngữ trong tính năng 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 đế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 nhật ký các vấn đề lên YouTube.

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 bổ sung.

Đị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

Có 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ộ thử nghiệm

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