YouTube 게임 룸 SDK - 시작하기

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

게임에 Playables SDK 추가

게임에는 루트 디렉터리에 index.html 파일이 있어야 합니다. 게임 코드 앞에 다음 줄을 추가하여 YouTube 게임 룸 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에 문제를 로깅합니다.

구현 세부정보 및 추가 함수는 Playables SDK 참조를 검토하세요.

TypeScript 유형 정의

TypeScript를 사용하는 게임의 경우 유형 정의를 다운로드합니다.

샘플 게임

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

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

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