Cu serviciile de jocuri Google Play, puteți adăuga jocurilor funcții sociale și multiplayer captivante.
Selectați una dintre funcțiile de mai jos pentru a afla informațiile de bază și a găsi documentația despre implementarea serviciilor de jocuri Google Play.
Începeți
Pentru a afla cum să integrezi SDK-ul pentru servicii de jocuri Google Play, accesează site-ul Google Developers ca să găsești instrucțiuni și exemple cu care să începi.
Pentru a folosi serviciile de jocuri Google Play, trebuie să creezi o înregistrare pentru joc în Play Console. Înregistrarea pentru joc este separată de pagina Înregistrare în magazin.
Iată cum poți adăuga o nouă înregistrare pentru joc:
- deschide Google Play Console;
- accesează Configurare
> Proiecte de joc;
- în dreapta sus, dă clic pe Adaugă un joc nou.
> Proiecte de joc;Funcții
Cu ajutorul realizărilor, puteți fideliza jucătorii adăugând recompense pentru îndeplinirea obiectivelor propuse în joc. Jucătorii pot câștiga puncte de experiență (XP) pentru îndeplinirea realizărilor din joc.
Accesează site-ul Google Developers pentru a afla mai multe despre Realizări.
Notă: după ce ai publicat o realizare, nu mai poate fi ștearsă.
Există două moduri de a crea realizări pentru prima dată folosind Google Play Console:
- creează o realizare: adaugă definiții și metadate pentru fiecare realizare, pe rând;
- importă realizăriimportă definiții și alte metadate pentru mai multe realizări în același timp.
Notă: folosește API-uri pentru a debloca realizări pentru jucătorul conectat. Astfel, jucătorul va vedea toate realizările ascunse.
Pentru a crea o realizare pentru un joc nou nepublicat, urmează acești pași folosind Google Play Console:
- în Google Play Console, selectează un joc;
- în pagina Servicii de jocuri Play – Realizări (Dezvoltă > Servicii de jocuri Play > Configurare și gestionare > Realizări), selectează Creează o realizare;
- în pagina Adaugă realizări, completează formularul;
- dă clic pe Salvează ca schiță.
După ce creezi o realizare, trebuie să publici jocul.
Adaugă mai multe realizări
Dacă ai deja realizări și vrei să adaugi mai multe:
-
în Google Play Console, selectează un joc;
-
în pagina Servicii de jocuri Play – Realizări (Dezvoltă > Servicii de jocuri Play > Configurare și gestionare > Realizări), selectează Adaugă realizări.
Pentru a adăuga mai multe realizări în joc simultan, urmează pașii de mai jos.
1. Creează un fișier ZIP care conține realizările tale.
1. Încarcă fișierul.
Pentru mai multe informații despre fișierul ZIP, consultă Regulamentul privind fișierele ZIP.
Pentru a importa realizări:
- în Google Play Console, selectează un joc;
- în pagina Servicii de jocuri Play – Realizări (Dezvoltă > Servicii de jocuri Play > Configurare și gestionare > Realizări), selectează Importă realizări;
- în pagina Importă realizări, dă clic pe Încarcă;
- selectează fișierul ZIP de încărcat;
- dă clic pe Salvează ca schiță.
- După ce imporți realizările, trebuie să publici jocul.
Editează o realizare
Pentru a edita o realizare pe care ai creat-o deja, selectează realizarea din fila Realizări în Google Play Console. În acest moment, vei vedea același formular pe care l-ai folosit la crearea inițială a realizării și poți să editezi oricare dintre câmpuri, după cum ai nevoie.
Când ai terminat de editat o realizare, dă clic pe butonul Salvează ca schiță. Realizarea nou editată va fi în etapa Pregătită pentru testare și o vei putea testa. Dacă funcționează corect, selectează Publică din nou din lista drop-down. Astfel, jocul va fi publicat din nou pentru public, împreună cu toate realizările actualizate.
Notă: după publicarea unei realizări, starea inițială (ascunsă sau dezvăluită) și tipul acesteia (incrementală sau standard) sunt fixe și nu pot fi modificate.
Anulează o modificare
Șterge o realizare
După publicarea realizării, aceasta nu poate fi ștearsă.
Poți șterge o realizare în starea prepublicată numai dacă dai clic pe butonul Șterge din partea de jos a formularului pentru realizarea respectivă.
Resetează o realizare
Poți reseta datele privind progresul jucătorului numai pentru realizările în lucru.
- Pentru a reseta realizări în Google Play Console, dă clic pe butonul Resetează progresul realizării din partea de jos a formularului pentru evenimentul respectiv.
- Pentru a reseta automat datele despre realizări, apelează metodele pentru Realizări ale API-ului Management.
Regulamentul privind pictogramele
Pictogramele trebuie create ca fișiere PNG, JPEG sau JPG de 512 x 512. Trebuie să ne trimiți doar pictograma pentru realizarea deblocată. Vom genera automat o versiune în tonuri de gri pentru pictograma dezvăluită. Din acest motiv, îți recomandăm ca pictogramele pentru realizări să includă elemente colorate, astfel încât utilizatorii să poată face distincția între realizările dezvăluite și cele deblocate.
Când o pictogramă de realizare este afișată într-o notificare toast pe Android, pictograma este suprapusă cu un cerc, iar colțurile sale exterioare sunt ascunse. Asigură-te că pictograma arată bine în aceste condiții.
Exemplu de pictogramă de realizare.
Se folosește aceeași pictogramă în toate limbile, prin urmare nu îți recomandăm să incluzi text sau conținut localizat într-o pictogramă.
Regulamentul privind fișierele ZIP
Poți să imporți mai multe realizări simultan folosind un fișier ZIP. Consultă tabelul pentru numele exacte ale fișierelor pe care să le folosești în fișierul ZIP:
|
Nume de fișier |
Obligatoriu sau opțional |
Valori acceptate |
|
|
Obligatoriu |
Metadatele pentru fiecare realizare. Consultă Atribute. |
|
|
Opțional |
Oferă traduceri pentru numele și descrierile realizărilor. |
|
|
Opțional |
Mapează realizările la fișierele cu pictograme asociate. |
|
Opțional |
Pictograme în format PNG, JPEG sau JPG. |
Cerințe privind fișierele ZIP:
- fără subdirectoare;
- nume de fișiere unice;
- numai fișiere CSV, PNG, JPEG sau JPG;
- fișierul CSV nu trebuie să aibă un rând de antet;
- fiecare fișier trebuie să aibă maximum 1 MB;
- numărul total de fișiere trebuie să fie mai mic de 203;
- dimensiunea totală a fișierului ZIP trebuie să fie mai mică de 200 MB.
Formatul AchievementsMetadata.csv
Fișierul AchievementsMetadata.csv conține metadatele pentru fiecare realizare. Trebuie să includă informațiile ca valori separate prin virgulă, în următoarea ordine:
Aceste câmpuri sunt descrise în următorul tabel:
|
Antete de coloană CSV |
Obligatorii sau opționale |
Valori acceptate |
|
Nume |
Obligatoriu |
Maximum 100 de caractere |
|
Descriere |
Opțional |
Maximum 500 de caractere |
|
Valoare incrementală |
Opțional |
Adevărat sau Fals |
|
Pași necesari |
Obligatorii dacă valoarea incrementală este setată la Adevărat. |
Număr (fără fracții sau zecimale) |
|
Stare inițială |
Obligatorie |
Ascunsă sau Dezvăluită |
|
Puncte |
Obligatorii |
Număr care este multiplu de 5, iar valoarea trebuie să fie între 5 și 200 |
|
Ordinea în listă |
Opțional |
Număr (fără fracții sau zecimale și mai mare decât zero) |
Cerințe privind fișierul AchievementsMetadata.csv:
- fiecare rând trebuie să aibă șapte valori. Dacă vrei să omiți o valoare, las-o necompletată.
- câmpurile Nume și Descriere sunt folosite drept cod local prestabilit;
- câmpul Nume trebuie să fie unic pentru toate realizările;
- următoarele câmpuri nu trebuie să conțină virgule: Nume și Descriere.
Exemplu de fișier AchievementsMetadata.csv:
Achievement1,,True,100,Hidden,5,20
Achievement2,,False,,Revealed,10,30
Formatul AchievementsLocalizations.csv
Fișierul AchievementsLocalizations.csv este un fișier opțional care configurează toate datele necesare pentru a descrie fiecare realizare utilizatorilor în diferite limbi. Realizările sunt traduse în funcție de codurile locale specificate pentru joc.
Trebuie să includă informațiile ca valori separate prin virgulă, în următoarea ordine:
Aceste câmpuri sunt descrise în următorul tabel:
|
Antete de coloană CSV |
Obligatorii sau opționale |
Descriere |
Valori acceptate |
|
Nume |
Obligatoriu |
Trebuie să corespundă coloanei Nume din |
Maximum 100 de caractere |
|
Nume localizat |
Obligatoriu |
Numele localizat pentru realizare. |
Maximum 100 de caractere |
|
Descriere localizată |
Opțional |
Descrierea localizată a realizării în limba specificată. |
Maximum 500 de caractere |
|
Cod local |
Obligatoriu |
Codul local, de exemplu, ro-RO. |
Adaugă traduceri pentru joc înainte de a specifica un cod local. Reține că nu poți să indici codul local prestabilit. Codurile locale acceptate se găsesc în lista de limbi acceptate. |
Cerințe privind fișierul AchievementsLocalizations.csv:
- numele realizărilor dintr-un joc trebuie să fie unice pentru fiecare cod local. De exemplu, dacă un joc acceptă atât codul local en-US, cât și fr-FR, o realizare numită „Realizare1” pentru en-US poate fi numită tot „Realizare1” pentru fr-FR.
- fiecare rând trebuie să aibă patru valori. Dacă vrei să omiți valoarea Descriere localizată, las-o necompletată.
Exemplu de fișier AchievementsLocalizations.csv:
Achievement1,Achievement One,This is the description of achievement one in English.,en-US
Achievement1,Achievement Un,Voici la description de l'achievement un en français.,fr-FR
Achievement2,Achievement Two,Description of achievement two.,en-US
Achievement2,Logro Dos,Descripción del logro dos.,es-ES
Achievement3,Achievement Three,,en-US
Achievement3,Erfolg Drei,,de-DE
Formatul AchievementsIconMappings.csv
Fișierul AchievementsIconMappings.csv este un fișier opțional folosit pentru a mapa realizările la pictograma respectivă. Trebuie să includă informațiile ca valori separate prin virgulă, în următoarea ordine:
Aceste câmpuri sunt descrise în următorul tabel:
|
Antete de coloană CSV |
Obligatorii sau opționale |
Descriere |
|
Nume |
Obligatoriu |
Trebuie să corespundă coloanei Nume din |
|
Numele de fișier al pictogramei |
Obligatoriu |
Numele fișierului cu pictograma. |
Cerințe privind fișierul AchievementsIconMappings.csv:
- fiecare rând trebuie să aibă două valori;
- fișierele cu pictograme pot fi numai în format PNG sau JPEG.
Exemplu de fișier AchievementsIconMappings.csv:
Valid Achievement,valid-achievement-icon.png
Incremental Achievement,incremental-achievement-icon.jpeg
No Description,no-description-icon.png
Hidden Initial State,hidden-initial-state-icon.png
Large Point Value,large-point-value-icon.jpeg
AchievementsIconMappings.csv trebuie să existe în arhiva ZIP actuală pe care o imporți. Pentru mai multe informații, consultă Regulamentul privind pictogramele.Poți specifica propriile traduceri pentru realizările asociate jocului. Înainte, parcurge pașii descriși în Adăugarea traducerilor pentru joc.
Există două moduri în care poți adăuga traduceri pentru joc:
- poți folosi opțiunea Importă realizări pentru a încărca traduceri pentru mai multe realizări noi simultan. Nu poți folosi această opțiune pentru a încărca traduceri pentru realizări existente.
- poți adăuga traduceri pentru fiecare realizare din joc. Pentru a adăuga propria traducere pentru fiecare realizare:
- în Google Play Console, deschide fila Realizări pentru joc, apoi selectează o realizare existentă;
- în pagina cu detaliile realizării, selectează fila pentru o limbă pe care ai adăugat-o anterior în fila Detalii despre joc;
- în pagina cu detaliile realizării pentru limba respectivă, editează formularul cu traducerile pentru acea realizare;
- dă clic pe Salvează pentru a stoca detaliile realizării traduse.
Cu ajutorul clasamentelor, poți oferi jucătorilor un loc unde își pot compara scorurile cu prietenii și pot concura cu jucători de top.
Notă: scorurile clasamentelor nu pot fi resetate, dar poți șterge sau ascunde un clasament oricând.
Pentru a ascunde scorurile suspecte din clasamentele existente, poți activa protecția împotriva modificărilor clasamentelor în pagina Clasamente a jocului din Play Console.
Creează un clasament
Ca să creezi un clasament pentru un joc nou și nepublicat, urmează acești pași:
- în Google Play Console, selectează un joc;
- accesează Dezvoltă > Servicii de jocuri Play > Configurare și gestionare > Clasamente, apoi dă clic pe butonul Creează un clasament;
- completează informațiile cerute pentru acest clasament;
- dă clic pe Salvează ca schiță și clasamentul va fi disponibil în starea Schiță;
- după ce publici jocul, toate clasamentele jocului sunt publicate împreună cu acesta.
Creează un clasament pentru un joc publicat
Pentru a crea un clasament suplimentar pentru un joc care a fost deja publicat, urmează pașii de mai sus. Pentru mai multe informații despre testarea unei versiuni actualizate a unui joc, consultă Publicarea modificărilor aduse jocului.
După ce ai testat clasamentul și dacă ești mulțumit(ă) de el, poți să republici jocul cu noile clasamente și acestea vor fi lansate în întreaga lume.
Editează un clasament
Pentru a edita un clasament pe care l-ai creat deja, dă clic pe clasament în fila Clasamente din Google Play Console. În acest moment, vei vedea același formular pe care l-ai folosit la crearea inițială a clasamentului și vei putea să editezi oricare dintre câmpuri, după cum este necesar.
După ce editezi un clasament, dă clic pe butonul Salvează ca schiță. Clasamentul editat recent va avea starea Schiță, astfel că îl poți testa.
Dacă funcționează corect, selectează Publică modificările din caseta din partea de sus a formularului pentru clasament și vei putea să republici jocul, împreună cu toate clasamentele actualizate, pentru public.
Anulează o modificare
Șterge un clasament
Poți șterge clasamente în starea Schiță sau care au fost publicate. Pentru a șterge un clasament din Google Play Console, accesează formularul pentru clasament și dă clic pe Șterge clasamentul în partea de sus a formularului.
Ca alternativă, poți apela Players.hide pentru a ascunde clasamentul unui jucător în aplicație.
Resetează un clasament
Poți să resetezi datele privind progresul jucătorului numai pentru clasamentele în lucru.
- Pentru a reseta clasamente în Google Play Console, dă clic pe Resetează progresul în partea de sus a formularului pentru evenimentul respectiv.
- Pentru a reseta automat datele clasamentului, apelează metodele pentru Scoruri ale API-ului Management.
Adaugă traduceri pentru clasamente
Poți specifica propriile traduceri pentru clasamentele asociate jocului. Înainte, parcurge pașii descriși în Adăugarea traducerilor pentru joc. În plus, trebuie să fi creat unul sau mai multe clasamente pentru joc.
Pentru a adăuga propriile traduceri pentru clasamente, deschide fila Clasamente pentru joc în Google Play Console, apoi selectează un clasament existent. În pagina cu detaliile clasamentului, dă clic pe fila pentru o limbă pe care ai adăugat-o anterior în fila Detalii despre joc. În pagina cu detaliile clasamentului pentru limba respectivă, editează formularul cu traducerile pentru acel clasament. Dă clic pe Salvează pentru a stoca detaliile clasamentului traduse.
Ascunde scoruri din clasament
Serviciile de jocuri Google Play oferă o funcție de protecție împotriva modificărilor clasamentului, care verifică dacă există scoruri suspecte de modificare și le ascunde automat. Funcția este disponibilă numai pentru jocurile Android.
Protecția împotriva modificărilor este activată în mod prestabilit pentru noile clasamente pe care le creezi pentru jocul Android, dar este dezactivată pentru clasamentele existente. Pentru a activa protecția împotriva modificărilor pentru clasamentele existente care sunt deja publicate, urmează pașii de mai jos:
- în Google Play Console, deschide fila Servicii de jocuri, apoi selectează jocul din listă;
- deschide fila Clasamente, apoi selectează instanța de clasament pentru care vrei să activezi protecția împotriva modificărilor;
- activează opțiunea Activează protecția împotriva modificărilor clasamentului;
- dă clic pe Salvează și continuă;
- publică jocul.
După ce activezi protecția împotriva modificărilor pentru un clasament în Google Play Console, poate dura până la 24 de ore pentru ca funcția să fie aplicată. Scorile trimise înainte de a activa protecția împotriva modificărilor nu sunt ascunse retroactiv.
În unele situații, îți recomandăm să dezactivezi protecția împotriva modificărilor (de exemplu, dacă jocul rulează și pe web, pe lângă Android, și folosește clasamente comune pe aceste platforme).
Accesează site-ul Google Developers pentru a afla cum să implementezi jocuri salvate.
Activează Jocuri salvate
Pentru a activa serviciul Jocuri salvate, urmează acești pași în Play Console:
- în Google Play Console, selectează un joc;
- în pagina Servicii de jocuri Play – Configurare (Dezvoltă > Servicii de jocuri Play > Configurare și gestionare > Configurare), selectează Editează proprietățile;
- setează opțiunea Jocuri salvate la ACTIVATĂ;
- dă clic pe Salvează.
După ce parcurgi pașii, poate dura până la 24 de ore pentru ca serviciile de jocuri Google Play să activeze serviciul Jocuri salvate pentru jocul tău. Dacă vrei să testezi imediat serviciul Jocuri salvate, șterge manual datele din aplicația Servicii Google Play de pe dispozitivul de test.
Pentru a șterge datele din memoria cache pe Android, deschide Setări > Aplicații > Servicii Google Play, dă clic pe Gestionează spațiul, apoi dă clic pe Șterge toate datele.
Pentru mai multe informații despre serviciul Jocuri salvate, consultă ghidul pentru Jocuri salvate.
Adaugă traduceri
Poți seta propriile traduceri pentru detaliile jocului, inclusiv numele afișat, descrierea jocului și elementele grafice. Poți și să specifici propriile traduceri pentru realizări și clasamente asociate jocului.
Pentru a adăuga propriile traduceri pentru detaliile jocului:
- în Google Play Console, selectează un joc;
- navighează la pagina Servicii de jocuri Play – Configurare (Dezvoltă > Servicii de jocuri Play > Configurare și gestionare > Configurare);
- selectează Editează proprietățile;
- selectează Gestionează traducerile > Gestionează propriile traduceri;
- selectează limbile pentru care vei adăuga traduceri, apoi dă clic pe Aplică pentru a confirma selecția. În pagina Proprietăți, limbile pe care le-ai selectat devin disponibile în selectorul de limbi.
- selectează limba pe care vrei să o editezi din selectorul de limbi, apoi editează formularul cu traduceri pentru numele afișat, descriere și elementele grafice;
- dă clic pe Salvează modificările pentru a stoca detaliile jocului traduse.
Pentru mai multe informații despre adăugarea traducerilor pentru realizări și clasamente, consultă ghidurile privind realizările și clasamentele.
Când afișează detaliile jocului, clasamentul și seriile de realizări, serviciile de jocuri Google Play folosesc limba acceptată de joc care este cea mai apropiată de limba solicitată de utilizator. De exemplu, dacă preferința de limbă a dispozitivului utilizatorului este setată la franceză (Canada) (fr-CA), dar jocul acceptă numai limbile engleză (Statele Unite) (en-US) și franceză (Franța) (fr-FR), serviciile de jocuri Google Play selectează șirurile fr-FR pentru afișare, deoarece aceasta este cea mai apropiată limbă.
Acordă permisiuni de modificare utilizatorilor
Pentru a automatiza configurarea aplicației și a integra versiunile în instrumentele și procesele automatizate existente, poți folosi API-ul Google Play Games Services Publishing. Iată cum să activezi accesul la API-ul Google Play Games Services Publishing folosind Play Console:
- deschide Google Play Console;
- accesează Configurare
- dacă nu ai făcut-o deja, creează un proiect conectat;
- Lângă „API-ul Games Configuration”, dați clic pe butonul Activați.
Gestionează mai mulți utilizatori
Dacă ai mai mulți utilizatori care gestionează jocuri în contul de dezvoltator, trebuie să gestionezi permisiunile în pagina Utilizatori și permisiuni din Play Console.