Nagrywanie filmów w grach na Androida

W związku z wycofaniem interfejsu Logowania przez Google w 2026 r. usuniemy pakiet SDK gier w wersji 1. Po lutym 2025 r. nie będzie można publikować w Google Play tytułów, które zostały dopiero zintegrowane z pakietem SDK gier w wersji 1. Zalecamy zamiast tego korzystać z pakietu SDK gier w wersji 2.
Chociaż istniejące tytuły z integracją poprzedniej wersji gry 1 będą działać przez kilka lat, zachęcamy do przejścia na wersję 2 od czerwca 2025 r.
Ten przewodnik dotyczy pakietu SDK usług gier Play w wersji 1. Pakiet SDK Usług gier Play w wersji 2 nie obsługuje nagrywania filmów.

Interfejs API nagrywania filmów umożliwia łatwe dodawanie nagrywania filmów do gry i umożliwia użytkownikom udostępnianie filmów 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 uruchamia funkcje nagrywania filmów w Grach 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 do nagrywania filmów:

• Pobierz i przejrzyj przykładowy kod.

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

Pobierz klienta filmów

Aby zacząć korzystać z interfejsu API nagrywania filmów, gra musi najpierw uzyskać obiekt VideosClient. Aby to zrobić, wywołaj metodę Games.getVideosClient(), przekazując w niej aktywność i GoogleSignInAccount dla bieżącego odtwarzacza. Aby dowiedzieć się, jak odzyskać informacje o koncie gracza, przeczytaj artykuł Logowanie się w Grach na Androida.

Podstawy interfejsu API do nagrywania filmów

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

Funkcja nagrywania wideo obejmuje:

• Nakładka nagrywania filmów, która ma 3 przyciski:

  1. Rozpocznij / zatrzymaj nagrywanie
  2. Włączanie i wyłączanie mikrofonu
  3. Włączanie i wyłączanie przedniego aparatu

• Przycisk udostępniony przez dewelopera do inicjowania nagrywania lub inny mechanizm nagrywania

• Klikalne powiadomienie, które pojawia się na końcu 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).

Uruchom nakładkę nagrywania filmu

Aby rozpocząć nagrywanie filmu w przypadku aktualnie zalogowanego odtwarzacza, 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ę uruchamiania nakładki nagrywania wideo.
3. Aby rozpocząć działanie, użyj intencji z poprzedniego kroku.

Oto przykład wywołania nakładki nagrywania filmu:

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 nagrywania filmów bezpośrednio w grze.