YouTube 게임 룸 SDK - 시작하기

YouTube Playables SDK는 웹 게임을 YouTube 환경과 연결하기 위한 웹 SDK입니다. 이 SDK는 다양한 방식으로 게임을 지원하여 YouTube에서 우수한 게임 환경을 만드는 강력한 API를 제공합니다.

게임에 Playables SDK 추가

게임의 루트 디렉터리에 index.html 파일이 있어야 합니다. 게임 코드 앞에 다음 줄을 추가하여 YouTube Playables SDK를 가져옵니다.

<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를 사용하는 게임의 경우 유형 정의 다운로드

샘플 게임

일반 JavaScript, Flutter 웹, Godot, Unity를 비롯하여 YouTube Playables SDK와 통합하는 방법을 보여주는 샘플을 사용할 수 있습니다.

테스트 모음으로 게임 테스트

준비가 되면 테스트 모음을 사용하여 통합을 검증할 수 있습니다. 방법을 알아보려면 테스트 모음 가이드를 따르세요.