gpg::AchievementManager

#include <achievement_manager.h>

उपलब्धि से जुड़ा अलग-अलग डेटा हासिल करता है और उसे सेट करता है.

खास जानकारी

सार्वजनिक टाइप
FetchAllCallback typedef
std::function< void(const FetchAllResponse &)>
यह ऐसे कॉलबैक टाइप को तय करता है जिसे FetchAllResponse मिलता है.
FetchCallback typedef
std::function< void(const FetchResponse &)>
यह ऐसे कॉलबैक टाइप को तय करता है जिसे FetchResponse मिलता है.
ShowAllUICallback typedef
std::function< void(const UIStatus &)>
यह ऐसे कॉलबैक टाइप को तय करता है जिसे UIStatus मिलता है.

सार्वजनिक फ़ंक्शन
Fetch(const std::string & achievement_id, FetchCallback callback)
void
फ़िलहाल साइन इन किए हुए प्लेयर की किसी खास उपलब्धि के लिए, डेटा एसिंक्रोनस रूप से लोड होता है.
Fetch(DataSource data_source, const std::string & achievement_id, FetchCallback callback)
void
फ़िलहाल साइन इन किए हुए प्लेयर की किसी खास उपलब्धि के लिए, डेटा एसिंक्रोनस रूप से लोड होता है.
FetchAll(FetchAllCallback callback)
void
मौजूदा समय में साइन इन किए हुए प्लेयर के लिए, उपलब्धि का सारा डेटा, एसिंक्रोनस तरीके से लोड होता है.
FetchAll(DataSource data_source, FetchAllCallback callback)
void
मौजूदा समय में साइन इन किए हुए प्लेयर के लिए, उपलब्धि का सारा डेटा, एसिंक्रोनस तरीके से लोड होता है.
FetchAllBlocking()
साइन इन किए हुए मौजूदा प्लेयर के लिए, उपलब्धि का सारा डेटा सिंक करके लोड करता है. यह डेटा, सीधे FetchAllResponse को दिखाता है.
FetchAllBlocking(DataSource data_source)
साइन इन किए हुए मौजूदा प्लेयर के लिए, उपलब्धि का सारा डेटा सिंक करके लोड करता है. यह डेटा, सीधे FetchAllResponse को दिखाता है.
FetchAllBlocking(Timeout timeout)
साइन इन किए हुए मौजूदा प्लेयर के लिए, उपलब्धि का सारा डेटा सिंक करके लोड करता है. यह डेटा, सीधे FetchAllResponse को दिखाता है.
FetchAllBlocking(DataSource data_source, Timeout timeout)
साइन इन किए हुए मौजूदा प्लेयर के लिए, उपलब्धि का सारा डेटा सिंक करके लोड करता है. यह डेटा, सीधे FetchAllResponse को दिखाता है.
FetchBlocking(const std::string & achievement_id)
साइन इन किए हुए प्लेयर के लिए, स्ट्रिंग आईडी से पहचानी जाने वाली किसी खास उपलब्धि के लिए सिंक्रोनस रूप से डेटा लोड करता है; सीधे FetchResponse दिखाता है.
FetchBlocking(DataSource data_source, const std::string & achievement_id)
साइन इन किए हुए प्लेयर के लिए, स्ट्रिंग आईडी से पहचानी जाने वाली किसी खास उपलब्धि के लिए सिंक्रोनस रूप से डेटा लोड करता है; सीधे FetchResponse दिखाता है.
FetchBlocking(Timeout timeout, const std::string & achievement_id)
साइन इन किए हुए प्लेयर के लिए, स्ट्रिंग आईडी से पहचानी जाने वाली किसी खास उपलब्धि के लिए सिंक्रोनस रूप से डेटा लोड करता है; सीधे FetchResponse दिखाता है.
FetchBlocking(DataSource data_source, Timeout timeout, const std::string & achievement_id)
साइन इन किए हुए प्लेयर के लिए, स्ट्रिंग आईडी से पहचानी जाने वाली किसी खास उपलब्धि के लिए सिंक्रोनस रूप से डेटा लोड करता है; सीधे FetchResponse दिखाता है.
Increment(const std::string & achievement_id)
void
दिए गए चरणों की संख्या से उपलब्धि को बढ़ाता है.
Increment(const std::string & achievement_id, uint32_t steps)
void
दिए गए चरणों की संख्या से उपलब्धि को बढ़ाता है.
Reveal(const std::string & achievement_id)
void
मौजूदा समय में साइन इन किए हुए खिलाड़ी को कोई छिपी हुई उपलब्धि दिखाएं.
SetStepsAtLeast(const std::string & achievement_id, uint32_t steps)
void
कम से कम चरणों को पूरा करने के लिए कोई उपलब्धि सेट करें.
ShowAllUI(ShowAllUICallback callback)
void
इससे उपयोगकर्ता को एक यूज़र इंटरफ़ेस (यूआई) दिखता है, जिसमें सभी उपलब्धियों की जानकारी दिखती है.
ShowAllUI()
void
अब सेवा में नहीं है. ShowAllUI(ShowAllUICallback कॉलबैक) को प्राथमिकता दें. इससे उपयोगकर्ता को एक यूज़र इंटरफ़ेस (यूआई) दिखता है, जिसमें सभी उपलब्धियों के बारे में जानकारी होती है. सभी प्लैटफ़ॉर्म पर, यूज़र इंटरफ़ेस (यूआई) एसिंक्रोनस तरीके से दिखाया जाता है.
ShowAllUIBlocking()
इससे उपयोगकर्ता को एक यूज़र इंटरफ़ेस (यूआई) दिखता है, जिसमें सभी उपलब्धियों की जानकारी दिखती है.
ShowAllUIBlocking(Timeout timeout)
इससे उपयोगकर्ता को एक यूज़र इंटरफ़ेस (यूआई) दिखता है, जिसमें सभी उपलब्धियों की जानकारी दिखती है.
Unlock(const std::string & achievement_id)
void
वर्तमान में प्रवेश किए हुए खिलाड़ी के लिए कोई उपलब्धि अनलॉक करता है.

संरचना
gpg::AchievementManager::FetchAllResponse

जवाब की स्थिति के साथ ही, सभी उपलब्धियों का पूरा डेटा रखता है.

gpg::AchievementManager::FetchResponse

इसमें एक उपलब्धि के लिए डेटा और उसके जवाब की स्थिति शामिल होती है.

सार्वजनिक टाइप

FetchAllCallback

std::function< void(const FetchAllResponse &)> FetchAllCallback

यह ऐसे कॉलबैक टाइप को तय करता है जिसे FetchAllResponse मिलता है.

यह कॉलबैक टाइप, नीचे दिए गए FetchAll(*) फ़ंक्शन को दिया जाता है.

FetchCallback

std::function< void(const FetchResponse &)> FetchCallback

यह ऐसे कॉलबैक टाइप को तय करता है जिसे FetchResponse मिलता है.

यह कॉलबैक टाइप, नीचे दिए गए Fetch(*) फ़ंक्शन को दिया जाता है.

ShowAllUICallback

std::function< void(const UIStatus &)> ShowAllUICallback

यह ऐसे कॉलबैक टाइप को तय करता है जिसे UIStatus मिलता है.

यह कॉलबैक टाइप, नीचे दिए गए ShowAllUI* फ़ंक्शन को दिया जाता है.

सार्वजनिक फ़ंक्शन

फ़ेच

void Fetch(
  const std::string & achievement_id,
  FetchCallback callback
)

फ़िलहाल साइन इन किए हुए प्लेयर की किसी खास उपलब्धि के लिए, डेटा एसिंक्रोनस रूप से लोड होता है.

कार्रवाई पूरी होने पर, दिए गए FetchCallback को कॉल करता है. data_source तय नहीं करने से यह फ़ंक्शन कॉल, Fetch(DataSource data_source, const std::string& id, FetchCallback) को कॉल करने के बराबर हो जाता है, जिसमें data_source का इस्तेमाल CACHE_OR_NETWORK के तौर पर किया जाता है.

फ़ेच

void Fetch(
  DataSource data_source,
  const std::string & achievement_id,
  FetchCallback callback
)

फ़िलहाल साइन इन किए हुए प्लेयर की किसी खास उपलब्धि के लिए, डेटा एसिंक्रोनस रूप से लोड होता है.

कार्रवाई पूरी होने पर, दिए गए FetchCallback को कॉल करता है. data_source को CACHE_OR_NETWORK या NETWORK_ONLY के तौर पर बताएं.

FetchAll

void FetchAll(
  FetchAllCallback callback
)

मौजूदा समय में साइन इन किए हुए प्लेयर के लिए, उपलब्धि का सारा डेटा, एसिंक्रोनस तरीके से लोड होता है.

कार्रवाई पूरी होने पर, दिए गए FetchAllCallback को कॉल करता है. data_source तय नहीं करने पर, यह फ़ंक्शन कॉल FetchAll(DataSource data_source, FetchAllCallback) को कॉल करने के बराबर हो जाता है, जिसमें data_source को CACHE_OR_NETWORK के तौर पर बताया जाता है.

FetchAll

void FetchAll(
  DataSource data_source,
  FetchAllCallback callback
)

मौजूदा समय में साइन इन किए हुए प्लेयर के लिए, उपलब्धि का सारा डेटा, एसिंक्रोनस तरीके से लोड होता है.

कार्रवाई पूरी होने पर, दिए गए FetchAllCallback को कॉल करता है. data_source को CACHE_OR_NETWORK या NETWORK_ONLY के तौर पर बताएं.

FetchAllBlocking

FetchAllResponse FetchAllBlocking()

साइन इन किए हुए मौजूदा प्लेयर के लिए, उपलब्धि का सारा डेटा सिंक करके लोड करता है. यह डेटा, सीधे FetchAllResponse को दिखाता है.

data_source और timeout, दोनों को तय करने से यह फ़ंक्शन कॉल FetchAllResponse FetchAllBlocking(DataSource data_source, Timeout timeout) के बराबर हो जाता है. इसमें data_source को CACHE_OR_NETWORK के तौर पर और timeout की वैल्यू 10 साल तय की जाती है.

FetchAllBlocking

FetchAllResponse FetchAllBlocking(
  DataSource data_source
)

साइन इन किए हुए मौजूदा प्लेयर के लिए, उपलब्धि का सारा डेटा सिंक करके लोड करता है. यह डेटा, सीधे FetchAllResponse को दिखाता है.

data_source को CACHE_OR_NETWORK या NETWORK_ONLY के तौर पर बताएं. timeout तय नहीं करने पर, यह फ़ंक्शन कॉल FetchAllBlocking FetchAllResponse(DataSource data_source, Timeout timeout) को कॉल करने के बराबर हो जाता है. इसमें data_source वैल्यू और timeout की वैल्यू 10 साल बताई जाती है.

FetchAllBlocking

FetchAllResponse FetchAllBlocking(
  Timeout timeout
)

साइन इन किए हुए मौजूदा प्लेयर के लिए, उपलब्धि का सारा डेटा सिंक करके लोड करता है. यह डेटा, सीधे FetchAllResponse को दिखाता है.

timeout को मिलीसेकंड की मनचाहे संख्या के तौर पर बताएं. data_source तय नहीं करने पर, यह फ़ंक्शन कॉल FetchAllResponse FetchAllBlocking(DataSource data_source, Timeout timeout) के बराबर हो जाता है, जिसमें data_source को CACHE_OR_NETWORK के तौर पर बताया जाता है और timeout में आपकी बताई गई वैल्यू होती है.

FetchAllBlocking

FetchAllResponse FetchAllBlocking(
  DataSource data_source,
  Timeout timeout
)

साइन इन किए हुए मौजूदा प्लेयर के लिए, उपलब्धि का सारा डेटा सिंक करके लोड करता है. यह डेटा, सीधे FetchAllResponse को दिखाता है.

data_source को CACHE_OR_NETWORK या NETWORK_ONLY के तौर पर बताएं. टाइम आउट को मिलीसेकंड की संख्या के हिसाब से तय करें.

FetchBlocking

FetchResponse FetchBlocking(
  const std::string & achievement_id
)

साइन इन किए हुए प्लेयर के लिए, स्ट्रिंग आईडी से पहचानी जाने वाली किसी खास उपलब्धि के लिए सिंक्रोनस रूप से डेटा लोड करता है; सीधे FetchResponse दिखाता है.

data_source और timeout को तय न करने पर, यह फ़ंक्शन कॉल FetchResponse FetchBlocking(DataSource data_source, Timeout timeout, const std::string& id) को कॉल करने के बराबर हो जाता है, जिसमें data_source को CACHE_OR_NETWORK के तौर पर और timeout को 10 साल के तौर पर बताया जाता है.

FetchBlocking

FetchResponse FetchBlocking(
  DataSource data_source,
  const std::string & achievement_id
)

साइन इन किए हुए प्लेयर के लिए, स्ट्रिंग आईडी से पहचानी जाने वाली किसी खास उपलब्धि के लिए सिंक्रोनस रूप से डेटा लोड करता है; सीधे FetchResponse दिखाता है.

data_source को CACHE_OR_NETWORK या NETWORK_ONLY के तौर पर बताएं. timeout को तय न करने पर, यह फ़ंक्शन कॉल FetchResponse FetchBlocking(DataSource data_source, Timeout timeout, const std::string& id) को कॉल करने के बराबर हो जाता है. इसमें data_source वैल्यू और timeout की वैल्यू 10 साल बताई जाती है.

FetchBlocking

FetchResponse FetchBlocking(
  Timeout timeout,
  const std::string & achievement_id
)

साइन इन किए हुए प्लेयर के लिए, स्ट्रिंग आईडी से पहचानी जाने वाली किसी खास उपलब्धि के लिए सिंक्रोनस रूप से डेटा लोड करता है; सीधे FetchResponse दिखाता है.

timeout को मिलीसेकंड की मनचाहे संख्या के तौर पर बताएं. data_source को सेट न करने पर, यह फ़ंक्शन कॉल FetchResponse FetchBlocking(DataSource data_source, Timeout timeout, const std::string& id) को कॉल करने के बराबर हो जाता है, जिसमें data_source को CACHE_OR_NETWORK के तौर पर बताया जाता है और timeout में आपकी बताई गई वैल्यू होती है.

FetchBlocking

FetchResponse FetchBlocking(
  DataSource data_source,
  Timeout timeout,
  const std::string & achievement_id
)

साइन इन किए हुए प्लेयर के लिए, स्ट्रिंग आईडी से पहचानी जाने वाली किसी खास उपलब्धि के लिए सिंक्रोनस रूप से डेटा लोड करता है; सीधे FetchResponse दिखाता है.

data_source को CACHE_OR_NETWORK या NETWORK_ONLY के तौर पर बताएं. timeout को मिलीसेकंड की मनचाहे संख्या के तौर पर बताएं.

इंक्रिमेंट

void Increment(
  const std::string & achievement_id
)

दिए गए चरणों की संख्या से उपलब्धि को बढ़ाता है.

बढ़ोतरी को तय न करने पर, इसकी वैल्यू डिफ़ॉल्ट रूप से 1 हो जाती है. उपलब्धि, इंक्रीमेंटल (बढ़ने वाली) उपलब्धि होनी चाहिए. किसी उपलब्धि के चरणों की तय सीमा पूरी हो जाने पर, वह अपने-आप अनलॉक हो जाती है. इसके बाद होने वाली किसी भी बढ़ोतरी को अनदेखा कर दिया जाता है.

इंक्रिमेंट

void Increment(
  const std::string & achievement_id,
  uint32_t steps
)

दिए गए चरणों की संख्या से उपलब्धि को बढ़ाता है.

उपलब्धि, इंक्रीमेंटल (बढ़ने वाली) उपलब्धि होनी चाहिए. किसी उपलब्धि के कम से कम चरणों में पहुंचने पर, वह अपने-आप अनलॉक हो जाएगी. इसके बाद होने वाली किसी भी बढ़ोतरी को अनदेखा कर दिया जाएगा.

रिवील

void Reveal(
  const std::string & achievement_id
)

मौजूदा समय में साइन इन किए हुए खिलाड़ी को कोई छिपी हुई उपलब्धि दिखाएं.

अगर उपलब्धि पहले ही अनलॉक की जा चुकी है, तो इसका कोई असर नहीं होगा.

SetStepsAtLeast

void SetStepsAtLeast(
  const std::string & achievement_id,
  uint32_t steps
)

कम से कम चरणों को पूरा करने के लिए कोई उपलब्धि सेट करें.

अगर उपलब्धि के लिए पहले से ही, दी गई वैल्यू से ज़्यादा चरण हैं, तो इस तरीके को कॉल करना, 'नहीं' की संख्या से ज़्यादा चरण हैं. जैसे ही उपलब्धि ज़्यादा से ज़्यादा चरणों तक पहुंच जाती है, तो उपलब्धि अपने-आप अनलॉक हो जाती है. साथ ही, आगे होने वाले किसी भी बदलाव को अनदेखा कर दिया जाता है.

ShowAllUI

void ShowAllUI(
  ShowAllUICallback callback
)

इससे उपयोगकर्ता को एक यूज़र इंटरफ़ेस (यूआई) दिखता है, जिसमें सभी उपलब्धियों की जानकारी दिखती है.

यह एसिंक्रोनस रूप से ShowAllUICallback को कॉल करता है.

ShowAllUI

void ShowAllUI()

अब सेवा में नहीं है. ShowAllUI(ShowAllUICallback कॉलबैक) को प्राथमिकता दें. इससे उपयोगकर्ता को एक यूज़र इंटरफ़ेस (यूआई) दिखता है, जिसमें सभी उपलब्धियों के बारे में जानकारी होती है. सभी प्लैटफ़ॉर्म पर, यूज़र इंटरफ़ेस (यूआई) एसिंक्रोनस तरीके से दिखाया जाता है.

ShowAllUIBlocking

UIStatus ShowAllUIBlocking()

इससे उपयोगकर्ता को एक यूज़र इंटरफ़ेस (यूआई) दिखता है, जिसमें सभी उपलब्धियों की जानकारी दिखती है.

यह सिंक्रोनस रूप से UIStatus दिखाता है. timeout तय नहीं करने पर, यह फ़ंक्शन कॉल 10 साल के लिए तय timeout के साथ ShowAllUIBlocking(Timeout timeout) को कॉल करने के बराबर हो जाता है.

ShowAllUIBlocking

UIStatus ShowAllUIBlocking(
  Timeout timeout
)

इससे उपयोगकर्ता को एक यूज़र इंटरफ़ेस (यूआई) दिखता है, जिसमें सभी उपलब्धियों की जानकारी दिखती है.

यह सिंक्रोनस रूप से UIStatus दिखाता है. timeout को मिलीसेकंड की मनचाहे संख्या के तौर पर बताएं.

अनलॉक करें

void Unlock(
  const std::string & achievement_id
)

वर्तमान में प्रवेश किए हुए खिलाड़ी के लिए कोई उपलब्धि अनलॉक करता है.

अगर उपलब्धि छिपी हुई है, तो SDK उसे भी दिखाता है.