Nagrywanie filmów w grach na Androida

Po wycofaniu interfejsu Google Sign-In API w 2026 roku usuniemy pakiet SDK do 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 gier. Zamiast tego zalecamy używanie pakietu SDK do 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 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.

Z tego przewodnika dowiesz się, 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 API nagrywania filmów:

• Pobierz i przejrzyj przykładowy kod.

• Zapoznaj się z rekomendacjami opisanymi w liście kontrolnej jakości.

Pobieranie klienta filmów

Aby zacząć korzystać z interfejsu API do nagrywania filmów, gra musi najpierw uzyskać obiekt VideosClient. Aby to zrobić, wywołaj metodę Games.getVideosClient() i przekaż do niej 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:

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.