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는 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에 문제를 로깅합니다.
  • ytgame.ads.requestInterstitialAd() 및 requestRewardedAd(rewardId: string) - 광고 기능을 게임에 통합합니다.

구현 세부정보와 추가 기능은 플레이어블 SDK 참조를 검토하세요.

TypeScript 유형 정의

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

샘플 게임

일반 JavaScript, Flutter 웹, Godot, Unity 등 YouTube 게임 SDK와 통합하는 방법을 보여주는 샘플이 제공됩니다.

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

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