gpg::
#include <game_services.h>
Google Play Games ile etkileşimde bulunmanın 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. Örnek, oluşturulduğunda Oyun Hizmetleri'nde oturum açılmaz (yani IsAuthorized() yanlış değerini döndürür). Arka planda sessiz bir oturum açma denemesi başlatılır. Kullanıcı, önceki bir oturumun sonunda oturum açmışsa bu girişim başarılı olabilir. Bu sessiz oturum açma denemesi tamamlanana kadar kullanıcı kimlik doğrulaması kullanıcı arayüzünün (ör. oturum açma ve/veya oturumu kapatma düğmeleri) devre dışı bırakılması veya gizlenmesi gerekir.
Bu sessiz oturum açma denemesi tamamlandığında, GameServices örneği için (GameServices::Builder::SetOnAuthActionFinished adresine kayıtlı) OnAuthActionFinished geri çağırmasına bildirim gönderilir. Geri çağırma bağımsız değişkenleri başarılı bir oturum açma girişimini yansıtırsa örneğin Oyun Hizmetleri'ne bağlı olduğu (yani IsAuthorized() "true" (doğru) değerini döndürür) ve oturum kapatma kullanıcı arayüzü etkinleştirilmelidir. Geri çağırma bağımsız değişkeni, başarısız bir oturum açma girişimini yansıtıyorsa oturum açma kullanıcı arayüzünün etkinleştirilmesi gerekir.
SignOut() yöntemi aracılığıyla yapılan açık oturum kapatma, yalnızca kullanıcı isteği üzerine çağrılmalıdır. Bu işlem, oturum kapalı durumuna geçiş yapılmasını ister. Bu geçişin tamamlandığı, OnAuthActionFinished geri çağırmasının çağrısıyla gösterilir. Bu geri çağırma işlemi yapılana kadar, diğer GameServices API'leri (StartAuthorizationUI() dahil) çağrılmamalıdır.
Bir GameServices örneği kaldırıldığında veri kaybını önlemek için bekleyen işlem kalmayana kadar örnek bloke edilir. Bu yok etmede engelleme davranışı istenmiyorsa Flush() verilmeli ve Flush() tamamlanana kadar GameServices örneği etkin tutulmalıdır.
GameServices'in 4.0'dan önceki Android sürümlerinde düzgün bir şekilde çalışabilmesi için sahip etkinliğin yaşam döngüsü geri çağırmaları yapması gerekir. AndroidSupport sayfasına göz atın.
Oluşturucular ve Yıkıcılar |
|
|---|---|
GameServices()
|
|
~GameServices()
|
Herkese açık türler |
|
|---|---|
FlushCallback
|
typedefstd::function< void(FlushStatus)>
Bir Flush işleminin sonucunu (durum) alan geri çağırma türünü tanımlar. |
Herkese açık işlevler |
|
|---|---|
Achievements()
|
Başarılara erişmek ve başarıları değiştirmek için kullanılan AchievementManager nesnesine referans sağlar.
|
Achievements() const
|
const AchievementManager &
Başarılara erişmek ve başarıları değiştirmek için kullanılan AchievementManager nesnesine const referansı sağlar.
|
Events()
|
Etkinliklere erişmek ve etkinlikleri değiştirmek için kullanılan EventManager nesnesine bir referans sağlar.
|
Events() const
|
const EventManager &
Etkinliklere erişmek ve etkinlikleri değiştirmek için kullanılan EventManager nesnesine bir const referansı sağlar.
|
Flush(FlushCallback callback)
|
void
Ana gönderme sırasını eşzamansız olarak temizler ve temizleme durumunu sağlanan FlushCallback'e döndürür.
|
FlushBlocking()
|
Eşzamanlı olarak temizlenir ve temizleme işleminin sonucunu (durumunu) alır.
|
FlushBlocking(Timeout timeout)
|
Eşzamanlı olarak temizlenir ve temizleme işleminin sonucunu (durumunu) alır.
|
IsAuthorized()
|
bool
Geçerli yetkilendirme durumunu açıkça kontrol etmenize olanak tanır.
|
Leaderboards()
|
Başarılara erişmek ve başarıları değiştirmek için kullanılan LeaderboardManager nesnesine bir referans sağlar.
|
Leaderboards() const
|
const LeaderboardManager &
Başarılara erişmek ve başarıları değiştirmek için kullanılan LeaderboardManager nesnesine bir const referansı sağlar.
|
Players()
|
PlayerManager nesnesine referans sağlar ve oyuncularla ilgili bilgilere erişim izni verir.
|
Players() const
|
const PlayerManager &
PlayerManager nesnesine, oynatıcılarla ilgili bilgilere erişim sağlayan bir const referansı sağlar.
|
RealTimeMultiplayer()
|
RTMP ile ilgili yöntemlere erişim sağlayan RealTimeMultiplayerManager nesnesine referans sağlar.
|
RealTimeMultiplayer() const
|
const RealTimeMultiplayerManager &
RTMP ile ilgili yöntemlere erişim sağlayan RealTimeMultiplayerManager nesnesine bir const referansı 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ı değiştirmek için kullanılan SnapshotManager nesnesine bir const referansı sağlar.
|
StartAuthorizationUI()
|
void
Platforma özel bir 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 const referansı sağlar.
|
TurnBasedMultiplayer()
|
TBMP ile ilgili yöntemlere erişim sağlayan TurnBasedMultiplayerManager nesnesine referans sağlar.
|
TurnBasedMultiplayer() const
|
const TurnBasedMultiplayerManager &
TBMP ile ilgili yöntemlere erişim sağlayan TurnBasedMultiplayerManager nesnesine const referansı sağlar.
|
Video()
|
Videoyla ilgili yöntemlere erişim sağlayan VideoManager nesnesine referans sağlar.
|
Video() const
|
const VideoManager &
VideoManager nesnesine, videoyla ilgili yöntemlere erişim sağlayan bir const referansı sağlar.
|
Sınıflar |
|
|---|---|
|
gpg:: |
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 (durum) alan geri çağırma türünü tanımlar.
Flush() işlevinde kullanılır.
Herkese açık işlevler
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 const referansı sağlar.
Etkinlikler
EventManager & Events()
Etkinliklere erişmek ve etkinlikleri değiştirmek için kullanılan EventManager nesnesine bir referans sağlar.
Etkinlikler
const EventManager & Events() const
Etkinliklere erişmek ve etkinlikleri değiştirmek için kullanılan EventManager nesnesine bir const referansı sağlar.
Gömme
void Flush( FlushCallback callback )
Ana gönderme sırasını eşzamansız olarak temizler ve temizleme 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 temizleme işleminin sonucunu (durumunu) alır.
Olası durumlar şunlardır: FLUSHED, ERROR_INTERNAL, ERROR_NOT_AUTHORIZED, ERROR_VERSION_UPDATE_REQUIRED ve ERROR_TIMEOUT. Bu zaman aşımının ayarlanmadan bırakılması, zaman aşımının 10 yıl olarak belirtildiği FlushStatus FlushBlocking(Timeout) çağrısıyla eşdeğer bir işlev çağrısı sağlar.
FlushBlocking
FlushStatus FlushBlocking( Timeout timeout )
Eşzamanlı olarak temizlenir ve temizleme işleminin sonucunu (durumunu) alır.
Olası durumlar şunlardır: FLUSHED, ERROR_INTERNAL, ERROR_NOT_AUTHORIZED, ERROR_VERSION_UPDATE_REQUIRED ve ERROR_TIMEOUT. Zaman aşımını isteğe bağlı bir milisaniye sayısı olarak belirtin.
GameServices
GameServices()=delete
IsAuthorized
bool IsAuthorized()
Geçerli yetkilendirme durumunu açıkça kontrol etmenize olanak tanır.
SDK tüketicilerinin, yoklama yerine yetkilendirme durumu değişikliklerini işlemek üzere AUTH_ACTION_* geri çağırmalarına kaydolması önerilir.
Skor tabloları
LeaderboardManager & Leaderboards()
Başarılara erişmek ve başarıları değiştirmek için kullanılan LeaderboardManager nesnesine bir referans sağlar.
Skor tabloları
const LeaderboardManager & Leaderboards() const
Başarılara erişmek ve başarıları değiştirmek için kullanılan LeaderboardManager nesnesine bir const referansı sağlar.
Oyuncular
PlayerManager & Players()
PlayerManager nesnesine referans sağlar ve oyuncularla ilgili bilgilere erişim izni verir.
Oyuncular
const PlayerManager & Players() const
PlayerManager nesnesine, oynatıcılarla ilgili bilgilere erişim sağlayan bir const referansı sağlar.
RealTimeMultiplayer
RealTimeMultiplayerManager & RealTimeMultiplayer()
RTMP ile ilgili yöntemlere erişim sağlayan RealTimeMultiplayerManager nesnesine referans sağlar.
RealTimeMultiplayer
const RealTimeMultiplayerManager & RealTimeMultiplayer() const
RTMP ile ilgili yöntemlere erişim sağlayan RealTimeMultiplayerManager nesnesine bir const referansı sağlar.
SignOut
void SignOut()
Eşzamansız oturum kapatma işlemini başlatır.
SignOut'u çağırdıktan sonra, başarılı bir çıkış yapıldığını belirten OnAuthActionFinishedCallback alana kadar GameServices üzerinde 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ı değiştirmek için kullanılan SnapshotManager nesnesine bir const referansı sağlar.
StartAuthorizationUI
void StartAuthorizationUI()
Platforma özel bir 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 const referansı sağlar.
TurnBasedMultiplayer
TurnBasedMultiplayerManager & TurnBasedMultiplayer()
TBMP ile ilgili yöntemlere erişim sağlayan TurnBasedMultiplayerManager nesnesine referans sağlar.
TurnBasedMultiplayer
const TurnBasedMultiplayerManager & TurnBasedMultiplayer() const
TBMP ile ilgili yöntemlere erişim sağlayan TurnBasedMultiplayerManager nesnesine bir const referansı sağlar.
Video
VideoManager & Video()
Videoyla ilgili yöntemlere erişim sağlayan VideoManager nesnesine referans sağlar.
Video
const VideoManager & Video() const
VideoManager nesnesine, videoyla ilgili yöntemlere erişim sağlayan bir const referansı sağlar.
~GameServices
~GameServices()