Nagrywanie filmów w grach na Androida

Po wycofaniu interfejsu Google Sign-In API w 2026 roku usuniemy pakiet SDK dla gier w wersji 1. Z końcem lutego 2025 r. nie będzie już można publikować w Google Play nowych tytułów, w których zastosowano integrację z wersją 1 pakietu SDK dla gier. Zamiast tego zalecamy używanie pakietu SDK dla gier w wersji 2.
Dotychczasowe tytuły z integracjami gier w wersji 1 będą działać jeszcze przez kilka lat, ale zachęcamy do przejścia na wersję 2 od czerwca 2025 r.
Ten przewodnik dotyczy korzystania z pakietu SDK dla usług gier Play w wersji 1. Nagrywanie filmów nie jest obsługiwane w pakiecie SDK usług gier Play w wersji 2.

Interfejs API nagrywania filmów umożliwia łatwe dodawanie nagrywania filmów do gry i pozwala użytkownikom udostępniać filmy znajomym w YouTube w kilku prostych krokach. Możesz na przykład dodać przycisk na ekranie powtórki bitwy, który po naciśnięciu uruchomi funkcję nagrywania wideo w Gry Play.

Ten przewodnik pokazuje, jak zaimplementować nagrywanie filmów w grach za pomocą usług Gier Google Play. Interfejsy API znajdują się w pakietach com.google.android.gms.games.video i com.google.android.gms.games.

Zanim zaczniesz

Zanim zaczniesz korzystać z interfejsu Video Recording API:

Pobieranie klienta filmów

Aby rozpocząć korzystanie z interfejsu API do nagrywania filmów, gra musi najpierw uzyskać obiekt VideosClient. Możesz to zrobić, wywołując metodę Games.getVideosClient() i przekazując aktywność oraz GoogleSignInAccount bieżącego gracza. Aby dowiedzieć się, jak pobrać informacje o koncie gracza, przeczytaj artykuł Logowanie się w grach na Androida.

Podstawowe informacje o interfejsie API do nagrywania filmów

Za pomocą interfejsu API do nagrywania filmów możesz zintegrować funkcję nagrywania filmów bezpośrednio w grze.

Nagrywanie filmów przez użytkowników obejmuje te funkcje:

  • Nakładka nagrywania wideo z 3 przyciskami:

    1. Rozpoczynanie i zatrzymywanie nagrywania
    2. Włączanie i wyłączanie mikrofonu
    3. Włączanie i wyłączanie przedniego aparatu

  • przycisk udostępniony przez dewelopera, który umożliwia rozpoczęcie nagrywania, lub alternatywny wyzwalacz nagrywania;

  • Klikalny komunikat, który pojawia się po zakończeniu nagrywania i umożliwia graczom przesłanie filmu do YouTube lub wyświetlenie go w aplikacji Zdjęcia (uwaga: nagrane filmy są przechowywane w kategorii ScreenCasts w Zdjęciach).

Uruchamianie nakładki nagrywania wideo

Aby rozpocząć nagrywanie filmu dla aktualnie zalogowanego gracza, wykonaj te czynności:

  1. Wywołaj metodę VideosClient.getCaptureOverlayIntent().
  2. Jeśli wywołanie się powiedzie, usługi Gier Google Play zwrócą obiekt Task, który asynchronicznie wczytuje intencję uruchomienia nakładki nagrywania wideo.
  3. Użyj intencji z poprzedniego kroku, aby rozpocząć aktywność.

Oto przykład, jak wyświetlić nakładkę nagrywania wideo:

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);
        }
      });
}

Wskazówki dotyczące korzystania z danych nagrywania wideo

Interfejs API nagrywania filmów umożliwia zintegrowanie funkcji nagrywania filmów bezpośrednio w grze.

Wskazówka Opis
Zadbaj o to, aby przycisk nagrywania filmu był łatwo widoczny.
  • umieścić przycisk nagrywania w widocznym miejscu poza menu głównym;
  • automatycznie wywoływać nakładkę za pomocą dedykowanej i wyraźnie oznaczonej opcji menu trybu nagrywania;
Promuj korzystanie z tej funkcji na stronie aplikacji i w grze.
  • Użyj zrzutu ekranu w informacjach o aplikacji, który wyświetla nakładkę nagrania wideo
  • Promowanie funkcji nagrywania filmów za pomocą promocji w grze
  • Rozważ przyznawanie nagród w grze za udostępnianie powtórek
Angażowanie społeczności graczy dzięki konkursom powtórek
  • Zachęcaj graczy do nagrywania i udostępniania powtórek rozgrywek, organizując cotygodniowe, comiesięczne i coroczne konkursy powtórek.
  • Wyróżniaj najpopularniejsze filmy i twórców w grze lub w mediach społecznościowych