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

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

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

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

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

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

Получить видеоклиент

Чтобы начать использовать API записи видео, ваша игра должна сначала получить объект VideosClient . Это можно сделать, вызвав метод Games.getVideosClient() и передав ему Activity и 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 записи видео позволяет интегрировать функцию записи видео непосредственно в вашу игру.

Кончик Описание
Сделайте так, чтобы триггер видеозаписи можно было легко обнаружить
  • Разместите кнопку записи на видном месте в главном меню.
  • Автоматически активируйте наложение из специального и четко обозначенного пункта меню режима записи.
Рекламируйте использование этой функции в описании вашего приложения в магазине и внутри игры.
  • Используйте снимок экрана в описании вашего продукта в магазине, на котором отображается наложение видеозаписи.
  • Продвигайте функцию записи видео с помощью внутриигровых акций.
  • Рассмотрите возможность предоставления внутриигровых наград за обмен повторами.
Привлекайте сообщество игроков с помощью конкурсов повторов
  • Поощряйте игроков записывать и делиться игровыми повторами с помощью еженедельных/ежемесячных/ежегодных конкурсов повторов.
  • Отмечайте лучшие видеоролики и авторов в игре или в социальных сетях