통합 요구사항

이 섹션에서는 Playable과 YouTube Playables SDK 간의 통합을 다룹니다.

1 Playables SDK 로드

2 게임 준비 완료 알림

  • 게임에서 로드 프로세스가 진행 중임을 사용자에게 명시적으로 전달하는 로드 화면 또는 스플래시 화면을 렌더링할 때 firstFrameReady를 호출해야 합니다.
  • 게임에서 MUST `gameReady`를 호출해야 gameReady **하며** 게임이 사용자 상호작용을 할 준비가 되었을 때만 MUST gameReady를 호출해야 **합니다**(예: 기본 메뉴 또는 게임을 플레이할 준비가 됨).
  • 상호작용할 수 없는 요소가 아직 사용자에게 표시되고 있으면 게임에서 호출해서는 gameReady **안 됩니다**(예: 스플래시 화면 또는 로드 화면).

YouTube는 이 API가 호출될 때까지 '로드 스피너'를 삭제하지 않습니다.

3 사용자 점수

  • 게임에서 sendScore를 사용하여 사용자 점수를 보낼 수 있습니다.
  • 게임에서 sendScore를 사용하여 점수를 보내는 경우 게임은 MUST sendScore 사양을 준수해야 하며 MUST 전송된 최고 점수가 게임 저장의 최고 점수와 일치하는지 확인해야 합니다.

4 클라우드 저장

  • 게임 메커니즘으로 인해 사용자가 진행 상황이 저장되었다고 생각하게 되는 중요한 게임 진행 상황 (예: 레벨 변경)이 발생한 경우 게임에서 MUST saveData를 호출하여 진행 상황을 저장해야 합니다.
  • 게임에서 사용자 진행 상황을 저장하는 데 다른 메커니즘을 사용해서는 안 됩니다. 이 기능을 사용하면 플레이어가 나중에 게임을 다시 시작할 수 있습니다.
  • 게임에서 saveData를 호출하기 전에 loadData를 대기해야 합니다. loadData가 성공적으로 완료되기 전에 saveData가 호출되면 요청이 거부됩니다. 이렇게 하면 게임에서 이전에 저장된 데이터를 덮어쓰는 것을 방지할 수 있습니다.
  • 게임에서 오류나 비정상 종료 없이 이전 버전의 게임에서 클라우드 저장 데이터를 사용할 수 있어야 합니다.
  • 게임에서 사용자가 데이터가 사용될 것으로 예상하는 모든 게임 버전에서 클라우드 저장 데이터를 사용하여 사용자 진행 상황을 유지하는 것이 좋습니다.
  • 게임에서 데이터 손실을 방지하기 위해 중요한 게임 마일스톤에서 사용자 진행 상황을 자동으로 저장하는 것이 좋습니다. 사용자가 게임을 종료할 때 최종 플러시 저장이 실행되지만 최선을 다해 실행되며 콘텐츠 길이를 최대 64KiB까지만 저장할 수 있습니다.

5 음소거 전환

  • 게임에서 시스템 오디오 설정 및 음소거 버튼을 준수해야 합니다.
  • 게임에서 isAudioEnabled 및 onAudioEnabledChange를 사용하여 YouTube 오디오 설정 및 음소거 버튼을 준수해야 합니다.
  • 게임에서 기기의 볼륨 조절을 준수해야 합니다.
  • 게임 사운드가 예기치 않게 재생되어서는 안 됩니다.
  • YouTube 음소거가 설정된 경우 오디오가 출력되어서는 안 되며 게임 오디오 컨트롤이 오디오 출력에 영향을 미쳐서는 안 됩니다.
  • YouTube 음소거가 설정되지 않은 경우 게임 오디오 컨트롤이 오디오 출력에 영향을 미칠 수 있습니다.
  • 게임 자체 내에서 전체 음소거 버튼을 표시해서는 안 되며 사용자가 YouTube 수준의 기능을 사용할 수 있도록 허용해야 합니다.
  • 게임에 음악 및 음향 효과와 같은 별도의 세부 오디오 컨트롤이 있을 수 있지만 다른 모든 오디오 컨트롤 요구사항을 준수해야 합니다.

배경, sfx, 대화의 오디오 설정이 다름

6 일시중지 및 계속

Playables SDK는 크로스 플랫폼 일시중지 및 계속 기능을 위한 콜백을 제공합니다.