Android 게임의 동영상 녹화

Google 로그인 API가 지원 중단됨에 따라 2026년에 게임 v1 SDK가 삭제됩니다. 2025년 2월 이후에는 게임 v1 SDK와 새로 통합된 타이틀을 Google Play에 게시할 수 없습니다. 대신 games v2 SDK를 사용하는 것이 좋습니다.
이전 게임 v1 통합이 적용된 기존 타이틀은 몇 년 동안 계속 작동하지만 2025년 6월부터는 v2로 이전하는 것이 좋습니다.
이 가이드는 Play 게임즈 서비스 v1 SDK 사용에 관한 가이드입니다. Play 게임즈 서비스 v2 SDK에서는 동영상 녹화가 지원되지 않습니다.

Video Recording API를 사용하면 게임에 동영상 녹화를 쉽게 추가하고 사용자가 몇 가지 간단한 단계로 YouTube에서 친구들과 동영상을 공유할 수 있습니다. 예를 들어 전투 재생 화면 밖에 버튼을 추가하여 이 버튼을 누르면 Play 게임즈 동영상 녹화 환경이 표시되도록 할 수 있습니다.

이 가이드에서는 Google Play 게임즈 서비스를 사용하여 게임에서 동영상 녹화를 구현하는 방법을 보여줍니다. API는 com.google.android.gms.games.video 및 com.google.android.gms.games 패키지에서 찾을 수 있습니다.

시작하기 전에

Video Recording API를 사용하기 전에 다음을 실행합니다.

• 코드 샘플을 다운로드하고 검토합니다.

• 품질 체크리스트에 설명된 권장사항을 숙지합니다.

동영상 클라이언트 가져오기

동영상 녹화 API를 사용하려면 먼저 게임에서 VideosClient 객체를 가져와야 합니다. 이렇게 하려면 Games.getVideosClient() 메서드를 호출하고 활동과 현재 플레이어의 GoogleSignInAccount를 전달하면 됩니다. 플레이어 계정 정보를 검색하는 방법을 알아보려면 Android 게임에서 로그인을 참고하세요.

동영상 녹화 API 기본사항

동영상 녹화 API를 사용하여 게임 내에서 직접 동영상 녹화 환경을 통합할 수 있습니다.

사용자의 동영상 녹화 환경에는 다음이 포함됩니다.

• 동영상 녹화 오버레이에는 다음과 같은 세 가지 버튼이 있습니다.

  1. 녹화 시작 / 중지
  2. 마이크 켜기 / 끄기
  3. 전면 카메라 켜기 / 끄기

• 녹화를 시작하는 개발자 제공 버튼 또는 대체 녹화 트리거

• 녹화 종료 시 표시되는 클릭 가능한 토스트로, 플레이어가 동영상을 YouTube에 업로드하거나 포토 앱을 통해 동영상을 볼 수 있습니다. (참고: 녹화된 동영상은 포토의 ScreenCasts 카테고리에 저장됨)

동영상 녹화 오버레이 실행

현재 로그인한 플레이어의 동영상 녹화를 시작하려면 다음 단계를 따르세요.

1. VideosClient.getCaptureOverlayIntent() 메서드를 호출합니다.
2. 호출에 성공하면 Google Play 게임즈 서비스는 동영상 녹화 오버레이를 실행하는 인텐트를 비동기식으로 로드하는 Task 객체를 반환합니다.
3. 이전 단계의 인텐트를 사용하여 활동을 시작합니다.

다음은 동영상 녹화 오버레이를 표시하는 방법의 예입니다.

private static final int RC_VIDEO_OVERLAY = 9011;

public void showVideoOverlay(View myview) {
  Games.getVideosClient(this, GoogleSignIn.getLastSignedInAccount(this))
      .getCaptureOverlayIntent()
      .addOnSuccessListener(new OnSuccessListener<Intent>() {
        @Override
        public void onSuccess(Intent intent) {
          startActivityForResult(intent, RC_VIDEO_OVERLAY);
        }
      });
}

동영상 녹화 데이터 사용 관련 도움말

동영상 녹화 API를 사용하면 게임에 동영상 녹화 환경을 직접 통합할 수 있습니다.