gpg::GameServices

#include <game_services.h>

Google Play Games ile etkileşimin başlangıç noktası.

Özet

Oyun Hizmetleri Yaşam Döngüsü

GameServices sınıfının bir örneği, GameServices::Builder aracılığıyla oluşturulur. Oluşturulduğunda örnek başlangıçta Oyun Hizmetleri'nde oturum açmaz (yani IsAuthorized() işlevi yanlış değerini döndürür). Sessiz bir oturum açma girişimi arka planda başlatılır ve kullanıcı önceki bir oturumun sonunda oturum açtıysa başarılı olabilir. Bu sessiz oturum açma denemesi tamamlanana kadar tüm kullanıcı kimlik doğrulama kullanıcı arayüzleri (ör. oturum açma ve/veya oturum kapatma düğmeleri) devre dışı bırakılmalı ya da gizlenmelidir.

Bu sessiz oturum açma denemesi tamamlandığında GameServices örneği için OnAuthActionFinished geri çağırması (GameServices::Builder::SetOnAuthActionFinished ile kayıtlı) bildirilir. Geri çağırma bağımsız değişkenleri başarılı bir oturum açma girişimini yansıtıyorsa örneğin Oyun Hizmetleri'ne bağlı olduğu varsayılabilir (yani IsAuthorized() doğru değerini döndürür) ve oturum kapatma kullanıcı arayüzünün etkinleştirilmesi gerekir. Geri çağırma bağımsız değişkeni başarısız bir oturum açma denemesini yansıtıyorsa oturum açma kullanıcı arayüzü etkinleştirilmelidir.

SignOut() yöntemiyle açık oturum kapatma, yalnızca kullanıcı isteği üzerine çağrılmalıdır. Bu işlem, oturum kapalı duruma geçiş yapılmasını gerektirir. Bu geçişin tamamlandığı, OnAuthActionFinished geri çağırmasının çağrılmasıyla gösterilir. Bu geri çağırma çağrılana kadar diğer GameServices API'leri (StartAuthorizationUI() dahil) çağrılmamalıdır.

Bir GameServices örneği imha edildiğinde, veri kaybını önlemek için beklemede olan işlem kalmayıncaya kadar engellenir. Bu engelleme davranışı istenmemişse bir Flush() işlemi yayınlanmalı ve GameServices örneği, Flush() tamamlanana kadar etkin tutulmalıdır.

GameServices uygulamasının 4.0'dan düşük Android sürümlerinde düzgün çalışması için, Activity'in sahibi olan kullanıcı yaşam döngüsü geri çağırma işlevini çağırmalıdır. AndroidSupport sayfasına bakın.

Oluşturucular ve Yıkıcılar
GameServices()
~GameServices()

Herkese açık türler
FlushCallback typedef
std::function< void(FlushStatus)>
Bir Flush işleminin sonucunu (durumunu) alan bir geri çağırma türünü tanımlar.

Kamu işlevleri
Achievements()
Başarılara erişmek ve başarıları değiştirmek için kullanılan AchievementManager nesnesine referans sağlar.
Achievements() const
Başarılara erişmek ve başarıları değiştirmek için kullanılan AchievementManager nesnesine ilişkin bir sabit referans sağlar.
Events()
Etkinliklere erişmek ve bunları işlemek için kullanılan EventManager nesnesine bir referans sağlar.
Events() const
const EventManager &
Etkinliklere erişmek ve bunları işlemek için kullanılan EventManager nesnesine bir konst referansı sağlar.
Flush(FlushCallback callback)
void
Ana dağıtım sırasını eşzamansız olarak temizler ve temizlemenin durumunu, sağlanan FlushCallback'e döndürür.
FlushBlocking()
Eşzamanlı olarak temizlenir ve sifondan bir sonuç (durum) alır.
FlushBlocking(Timeout timeout)
Eşzamanlı olarak temizlenir ve sifondan bir sonuç (durum) alır.
IsAuthorized()
bool
Mevcut yetkilendirme durumunu açık bir şekilde kontrol etmenize olanak tanır.
Leaderboards()
Başarılara erişmek ve bunları değiştirmek için kullanılan LeaderboardManager nesnesine referans sağlar.
Leaderboards() const
Başarılara erişmek ve bunları değiştirmek için kullanılan LeaderboardManager nesnesine bir konst referansı sağlar.
Players()
PlayerManager nesnesine, oynatıcılarla ilgili bilgilere erişim sağlayan bir referans sağlar.
Players() const
const PlayerManager &
PlayerManager nesnesine bir konst referansı sağlar. Bu da oynatıcılarla ilgili bilgilere erişim sağlar.
RealTimeMultiplayer()
RTMP ile ilgili yöntemlere erişim sağlayan RealTimeMultiplayerManager nesnesine bir referans sağlar.
RealTimeMultiplayer() const
RealTimeMultiplayerManager nesnesine bir konst referansı sağlar. Bu, RTMP ile ilgili yöntemlere erişim sağlar.
SignOut()
void
Eşzamansız oturum kapatma işlemini başlatır.
Snapshots()
Anlık görüntülere erişmek ve bunları değiştirmek için kullanılan SnapshotManager nesnesine bir referans sağlar.
Snapshots() const
const SnapshotManager &
Anlık görüntülere erişmek ve bunları yönetmek için kullanılan SnapshotManager nesnesine bir konst referansı sağlar.
StartAuthorizationUI()
void
Platforma özgü kullanıcı yetkilendirme akışı sunar.
Stats()
Oyun ve oyuncu istatistiklerine erişmek için kullanılan StatsManager nesnesine bir referans sağlar.
Stats() const
const StatsManager &
Oyun ve oyuncu istatistiklerine erişmek için kullanılan StatsManager nesnesine bir sabit referans sağlar.
TurnBasedMultiplayer()
TBMP ile ilgili yöntemlere erişim sağlayan TurnBasedMultiplayerManager nesnesine bir referans sağlar.
TurnBasedMultiplayer() const
TurnBasedMultiplayerManager nesnesine yönelik bir konst referansı sağlar ve TBMP ile ilgili yöntemlere erişim sağlar.
Video()
Videoyla ilgili yöntemlere erişim sağlayan VideoManager nesnesine bir referans sağlar.
Video() const
const VideoManager &
VideoManager nesnesine bir konst referansı sağlar. Bu, videoyla ilgili yöntemlere erişim sağlar.

Sınıflar
gpg::GameServices::Builder

GameServices sınıfının bir örneğini oluşturmak ve yapılandırmak için kullanılır.

Herkese açık türler

FlushCallback

std::function< void(FlushStatus)> FlushCallback

Bir Flush işleminin sonucunu (durumunu) alan bir geri çağırma türünü tanımlar.

Flush() işlevinde kullanılır.

Kamu işlevleri

Başarılar

AchievementManager & Achievements()

Başarılara erişmek ve başarıları değiştirmek için kullanılan AchievementManager nesnesine referans sağlar.

Başarılar

const AchievementManager & Achievements() const

Başarılara erişmek ve başarıları değiştirmek için kullanılan AchievementManager nesnesine ilişkin bir sabit referans sağlar.

Etkinlikler

EventManager & Events()

Etkinliklere erişmek ve bunları işlemek için kullanılan EventManager nesnesine bir referans sağlar.

Etkinlikler

const EventManager & Events() const

Etkinliklere erişmek ve bunları işlemek için kullanılan EventManager nesnesine bir konst referansı sağlar.

Sifon

void Flush(
  FlushCallback callback
)

Ana dağıtım sırasını eşzamansız olarak temizler ve temizlemenin durumunu, sağlanan FlushCallback'e döndürür.

Olası durumlar şunlardır: FLUSHED, ERROR_INTERNAL ve ERROR_VERSION_UPDATE_REQUIRED.

FlushBlocking

FlushStatus FlushBlocking()

Eşzamanlı olarak temizlenir ve sifondan bir sonuç (durum) alır.

Olası durumlar şunlardır: FLUSHED, ERROR_INTERNAL, ERROR_NOT_AUTHORIZED, ERROR_VERSION_UPDATE_REQUIRED ve ERROR_TIMEOUT. Bu zaman aşımını belirtmeden bırakırsanız bu işlev çağrısı, Zaman Aşımı 10 yıl olarak belirtildiğinde FlushStatus FlushBlocking(Timeout) çağrısına eşdeğer olur.

FlushBlocking

FlushStatus FlushBlocking(
  Timeout timeout
)

Eşzamanlı olarak temizlenir ve sifondan bir sonuç (durum) alır.

Olası durumlar şunlardır: FLUSHED, ERROR_INTERNAL, ERROR_NOT_AUTHORIZED, ERROR_VERSION_UPDATE_REQUIRED ve ERROR_TIMEOUT. Rastgele bir milisaniye sayısı olarak zaman aşımını belirtin.

GameServices

 GameServices()=delete

IsAuthorized

bool IsAuthorized()

Mevcut yetkilendirme durumunu açık bir şekilde kontrol etmenize olanak tanır.

SDK tüketicilerinin, yoklama yapmak yerine yetkilendirme durumu değişikliklerini işlemek için AUTH_ACTION_* geri çağırmalarına kaydolmaları önerilir.

Skor tabloları

LeaderboardManager & Leaderboards()

Başarılara erişmek ve bunları değiştirmek için kullanılan LeaderboardManager nesnesine referans sağlar.

Skor tabloları

const LeaderboardManager & Leaderboards() const

Başarılara erişmek ve bunları değiştirmek için kullanılan LeaderboardManager nesnesine bir konst referansı sağlar.

Oyuncular

PlayerManager & Players()

PlayerManager nesnesine, oynatıcılarla ilgili bilgilere erişim sağlayan bir referans sağlar.

Oyuncular

const PlayerManager & Players() const

PlayerManager nesnesine bir konst referansı sağlar. Bu da oynatıcılarla ilgili bilgilere erişim sağlar.

RealTimeMultiplayer

RealTimeMultiplayerManager & RealTimeMultiplayer()

RTMP ile ilgili yöntemlere erişim sağlayan RealTimeMultiplayerManager nesnesine bir referans sağlar.

RealTimeMultiplayer

const RealTimeMultiplayerManager & RealTimeMultiplayer() const

RealTimeMultiplayerManager nesnesine bir konst referansı sağlar. Bu, RTMP ile ilgili yöntemlere erişim sağlar.

SignOut

void SignOut()

Eşzamansız oturum kapatma işlemini başlatır.

SignOut'u çağırdıktan sonra, başarıyla çıkış yapıldığını belirten OnAuthActionFinishedCallback'i alana kadar GameServices'de herhangi bir işlem çağırmamalısınız.

Anlık Görüntüler

SnapshotManager & Snapshots()

Anlık görüntülere erişmek ve bunları değiştirmek için kullanılan SnapshotManager nesnesine bir referans sağlar.

Anlık Görüntüler

const SnapshotManager & Snapshots() const

Anlık görüntülere erişmek ve bunları yönetmek için kullanılan SnapshotManager nesnesine bir konst referansı sağlar.

StartAuthorizationUI

void StartAuthorizationUI()

Platforma özgü kullanıcı yetkilendirme akışı sunar.

İstatistikler

StatsManager & Stats()

Oyun ve oyuncu istatistiklerine erişmek için kullanılan StatsManager nesnesine bir referans sağlar.

İstatistikler

const StatsManager & Stats() const

Oyun ve oyuncu istatistiklerine erişmek için kullanılan StatsManager nesnesine bir sabit referans sağlar.

TurnBasedMultiplayer

TurnBasedMultiplayerManager & TurnBasedMultiplayer()

TBMP ile ilgili yöntemlere erişim sağlayan TurnBasedMultiplayerManager nesnesine bir referans sağlar.

TurnBasedMultiplayer

const TurnBasedMultiplayerManager & TurnBasedMultiplayer() const

TurnBasedMultiplayerManager nesnesine yönelik bir konst referansı sağlar ve TBMP ile ilgili yöntemlere erişim sağlar.

Video

VideoManager & Video()

Videoyla ilgili yöntemlere erişim sağlayan VideoManager nesnesine bir referans sağlar.

Video

const VideoManager & Video() const

VideoManager nesnesine bir konst referansı sağlar. Bu, videoyla ilgili yöntemlere erişim sağlar.

~Oyun Hizmetleri

 ~GameServices()