Запись видео в играх Android

В связи с прекращением поддержки API Google Sign-In , мы удаляем SDK для игр версии 1 в 2026 году. После февраля 2025 года вы не сможете публиковать в Google Play игры, которые были интегрированы с SDK для игр версии 1. Мы рекомендуем использовать вместо него SDK для игр версии 2.
Хотя существующие игры с интеграцией предыдущих версий v1 будут продолжать работать еще пару лет, мы рекомендуем перейти на версию v2, начиная с июня 2025 года.
Данное руководство предназначено для использования SDK Play Games Services v1. Запись видео не поддерживается в SDK Play Games Services v2.

API для записи видео позволяет легко добавить функцию записи видео в вашу игру и дать пользователям возможность делиться своими видео с друзьями на YouTube всего за несколько простых шагов. Например, вы можете добавить кнопку на экране повтора боя, при нажатии на которую будет открываться окно записи видео в Play Games.

В этом руководстве показано, как реализовать запись видео в играх с помощью сервисов Google Play Games. API можно найти в пакетах com.google.android.gms.games.video и com.google.android.gms.games .

Прежде чем начать

Перед началом использования API для записи видео:

• Скачайте и просмотрите пример кода .

• Ознакомьтесь с рекомендациями, описанными в Контрольном списке качества .

Загрузите видеоклиент

Для начала использования API записи видео ваша игра должна получить объект VideosClient . Это можно сделать, вызвав метод Games.getVideosClient() и передав в него активность и учетную GoogleSignInAccount текущего игрока. Чтобы узнать, как получить информацию об учетной записи игрока, см. раздел «Вход в систему в играх Android» .

Основы API для видеозаписи

Вы можете использовать API для записи видео, чтобы интегрировать функцию записи видео непосредственно в вашу игру.

Для пользователей процесс видеозаписи включает в себя следующее:

• Наложение видеозаписи, имеющее три кнопки:

  1. Начать/остановить запись
  2. Включение/выключение микрофона
  3. Включение/выключение фронтальной камеры

• Кнопка, предоставленная разработчиком, для начала записи или альтернативный способ запуска записи.

• В конце записи появляется всплывающее уведомление, позволяющее загрузить видео на YouTube или просмотреть его через приложение «Фотографии» (Примечание: записанные видео хранятся в категории ScreenCasts в приложении «Фотографии»).

Запустите наложение записи видео.

Чтобы начать запись видео для текущего пользователя, выполните следующие действия:

1. Вызовите метод VideosClient.getCaptureOverlayIntent() .
2. В случае успешного выполнения вызова сервисы Google Play Games возвращают объект Task , который асинхронно загружает Intent для запуска наложения видеозаписи.
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 для записи видео позволяет интегрировать функцию записи видео непосредственно в вашу игру.