Perekaman video di game Android

Setelah penghentian penggunaan API Login dengan Google, kami akan menghapus SDK game v1 pada tahun 2026. Setelah Februari 2025, Anda tidak akan dapat memublikasikan judul yang baru diintegrasikan dengan SDK game v1, di Google Play. Sebaiknya gunakan SDK game v2.
Meskipun game lama dengan integrasi game v1 sebelumnya akan terus berfungsi selama beberapa tahun, sebaiknya Anda bermigrasi ke v2 mulai Juni 2025.
Panduan ini ditujukan untuk penggunaan SDK Layanan game Play v1. Perekaman video tidak didukung di SDK Layanan game Play v2.

Video Recording API memungkinkan Anda menambahkan perekaman video ke game dengan mudah dan memungkinkan pengguna membagikan video mereka kepada teman-teman di YouTube dalam beberapa langkah sederhana. Misalnya, Anda dapat menambahkan tombol di luar layar replay pertarungan yang jika ditekan akan memunculkan pengalaman perekaman video Play Game.

Panduan ini menunjukkan cara menerapkan perekaman video dalam game menggunakan Layanan game Google Play. API ini dapat ditemukan dalam paket com.google.android.gms.games.video dan com.google.android.gms.games.

Sebelum memulai

Sebelum Anda mulai menggunakan API perekaman video:

• Download dan tinjau contoh kode.

• Pahami rekomendasi yang dijelaskan dalam Checklist Kualitas.

Mendapatkan klien video

Untuk mulai menggunakan API perekaman video, game Anda harus mendapatkan objek VideosClient terlebih dahulu. Anda dapat melakukannya dengan memanggil metode Games.getVideosClient() dan meneruskan aktivitas dan GoogleSignInAccount untuk pemutar saat ini. Untuk mempelajari cara mengambil informasi akun pemain, lihat Login di Game Android.

Catatan: Class VideosClient menggunakan class Task layanan Google Play untuk menampilkan hasil secara asinkron. Untuk mempelajari lebih lanjut cara menggunakan tugas untuk mengelola tugas berangkai, lihat panduan developer Tasks API.

Dasar-dasar API perekaman video

Anda dapat menggunakan API perekaman video untuk mengintegrasikan pengalaman perekaman video langsung dari dalam game Anda.

Pengalaman perekaman video untuk pengguna mencakup hal berikut:

• Overlay rekaman video, yang memiliki tiga tombol:

  1. Memulai / menghentikan perekaman
  2. Mengaktifkan / menonaktifkan mikrofon
  3. Mengaktifkan / menonaktifkan kamera depan
  Catatan: Mengklik tampilan kamera depan overlay akan memunculkan tiga tombol yang disebutkan di atas.

• Tombol yang disediakan developer untuk memulai perekaman, atau pemicu perekaman alternatif

• Notifikasi pop-up yang dapat diklik di akhir perekaman yang memungkinkan pemain mengupload video ke YouTube, atau melihat video melalui aplikasi Foto (Catatan: video yang direkam disimpan dalam kategori ScreenCasts di Foto)

Meluncurkan overlay perekaman video

Untuk memulai perekaman video bagi pemain yang saat ini login, ikuti langkah-langkah berikut:

1. Panggil metode VideosClient.getCaptureOverlayIntent().
2. Jika panggilan berhasil, Layanan game Google Play akan menampilkan objek Task yang secara asinkron memuat intent untuk meluncurkan overlay perekaman video.
3. Gunakan intent dari langkah sebelumnya untuk memulai aktivitas.

Berikut adalah contoh cara menampilkan overlay perekaman video:

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

Tips untuk menggunakan data perekaman video

Video Recording API memungkinkan Anda mengintegrasikan pengalaman perekaman video langsung di game.

Tips	Deskripsi
Membuat pemicu perekaman video mudah ditemukan	Tempatkan tombol perekaman di luar menu utama Anda Memicu overlay secara otomatis dari opsi menu mode perekaman khusus dan berlabel jelas
Promosikan penggunaan fitur di listingan Play Store dan di dalam game	Gunakan screenshot di listingan Play Store yang menampilkan overlay rekaman video Mempromosikan fitur perekaman video melalui promosi dalam game Pertimbangkan untuk memberikan reward dalam game untuk berbagi replay
Libatkan komunitas pemain Anda dengan kompetisi tonton ulang	Dorong pemain untuk merekam dan membagikan rekaman ulang game dengan kompetisi rekaman ulang mingguan / bulanan / tahunan Mengakui video dan kreator teratas dalam game atau melalui media sosial