Tambahkan acara ke game Anda

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. SDK C++ untuk Layanan game Play v2 belum tersedia.

Panduan ini menunjukkan cara menggunakan layanan Events di aplikasi C++.

Sebelum memulai

Jika Anda belum melakukannya, sebaiknya tinjau konsep game peristiwa.

Untuk menyiapkan lingkungan pengembangan C++ agar dapat menggunakan layanan Peristiwa, ikuti petunjuk dalam panduan Mulai Menggunakan C++. Anda dapat mendownload SDK C++ layanan game Play dari halaman hasil download SDK.

Sebelum game Anda dapat mengakses peristiwa, Anda harus menentukannya terlebih dahulu di Konsol Google Play.

Mengirimkan acara

Anda dapat menambahkan kode dalam game untuk memberi tahu layanan Peristiwa setiap kali terjadi peristiwa yang menarik untuk game Anda. Contoh peristiwa yang dapat Anda rekam dalam game adalah: membunuh musuh, menjelajahi atau kembali ke berbagai wilayah game, atau mendapatkan item dalam game. Biasanya, Anda akan memanggil metode Increment di pengelola peristiwa untuk menambahkan jumlah peristiwa sebanyak 1 setiap kali pemutar melakukan tindakan yang terkait dengan peristiwa (misalnya, “Membunuh satu monster”).

Contoh berikut menunjukkan cara mengirimkan jumlah peristiwa yang diperbarui ke layanan Peristiwa.

  // Increment the event count when player performs the 'Attack blue
  // monster' action.
  game_services_->Events().Increment(BLUE_MONSTER_EVENT_ID);

Mengambil peristiwa

Untuk mengambil nilai hitungan saat ini yang disimpan di server Google untuk peristiwa tertentu, panggil salah satu metode Fetch*. Anda dapat melakukannya, misalnya, jika Anda ingin menampilkan statistik atau progres dalam game pemain dari UI kustom di game Anda.

Contoh berikut menunjukkan cara mengambil dan mencatat data peristiwa dalam game Anda.

  // Log Events details.
  LogI("---- Showing Event Counts -----");
  gpg::EventManager::FetchAllCallback callback =
      [](gpg::EventManager::FetchAllResponse const &response) {
    for (auto i : response.data) {
      gpg::Event const &event = i.second;
      LogI("Event name: %s  count: %d", event.Name().c_str(),
           event.Count());
    }
  };
  game_services_->Events().FetchAll(callback);