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

SDK YouTube Playables 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, từ đó mang đến trải nghiệm chơi trò chơi tuyệt vời trên YouTube.

Thêm SDK Playables vào trò chơi

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

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

SDK sẽ chạy ở chế độ không hoạt độ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 việc 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 SDK Playables

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

Các công cụ tích hợp bắt buộc

Xem xét tổng thể các yêu cầu phát hành, tập trung vào các yêu cầu tích hợp. Xem tài liệu tham khảo về SDK Playables để 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 chức năng tích hợp bắt buộc, bạn còn có thể sử dụng một số chức năng khác để tạo ra trải nghiệm hấp dẫn. Ví dụ:

  • ytgame.system.getLanguage() – Sử dụng để 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 tính năng lưu vào đám mây, vì ngôn ngữ này 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ý vấn đề vào YouTube.

Xem tài liệu tham khảo về SDK có thể chơi để biết thông tin chi tiết về cách triển khai và các chức năng 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

Chúng tôi có các mẫu minh hoạ cách tích hợp với SDK YouTube Playables, bao gồm JavaScript thuần tuý, web Flutter, 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ử.