Google Play ‑pelipalvelujen avulla voit lisätä peleihisi kiinnostavia sosiaalisia ja moninpeliominaisuuksia.
Valitse ominaisuus alta, niin voit tutustua sen perustietoihin ja Google Play ‑pelipalvelujen käyttöönotto-oppaisiin.
Aloittaminen
Google Play ‑pelipalvelujen SDK:n integrointiLöydät Google Playn pelipalvelujen integrointiohjeita ja aloittamista helpottavia esimerkkejä Google Developers ‑sivustolta.
Jos haluat käyttää Google Playn pelipalveluja, sinun täytyy luoda pelille tietosivu Play Consolessa. Pelin tietosivu ei ole sama kuin sovelluksen tietosivu.
Lisää uusi pelin tietosivu näin:
- Avaa Google Play Console.
- Valitse Määritys
> Peliprojektit.
- Valitse oikeasta yläkulmasta Lisää uusi peli.
Ominaisuudet
SaavutuksetSaavutuksilla voit säilyttää pelaajat paremmin lisäämällä palkintoja pelissä asetettujen tavoitteiden saavuttamisesta. Pelaajat voivat kerätä kokemuspisteitä (XP) pelissä suoritetuista saavutuksista.
Lue lisää saavutuksista Google Developers ‐sivustolta.
Huom. Julkaistuja saavutuksia ei voi poistaa.
Saavutusten lisääminen
Voit luoda saavutuksia ensimmäistä kertaa Google Play Consolessa kahdella tavalla:
- Saavutuksen luominen: Lisää saavutusten määritelmät ja metadata yksi kerrallaan.
- Saavutusten tuominen: Tuo useiden saavutusten määritelmät ja muu metadata yhdellä kertaa.
Huom. APIen avulla voit avata saavutuksia kirjautuneelle pelaajalle. Tällöin pelaaja näkee kaikki piilotetut saavutukset.
Saavutuksen luominen
Näin voit luoda saavutuksen uudelle ja julkaisemattomalle pelille Google Play Consolessa:
- Valitse peli Google Play Consolesta.
- Valitse Playn pelipalvelut – Saavutukset -sivulta (Kasvu > Playn pelipalvelut > Käyttöönotto ja ylläpito > Saavutukset) Luo saavutus.
- Täytä Lisää saavutuksia ‐sivulla oleva lomake.
- Valitse Tallenna luonnoksena.
Kun olet luonut saavutuksen, sinun on julkaistava peli.
Useampien saavutusten lisääminen
Jos sinulla on jo saavutuksia ja haluat lisätä useampia:
-
Valitse peli Google Play Consolesta.
-
Valitse Playn pelipalvelut – Saavutukset -sivulta (Kasvu > Playn pelipalvelut > Käyttöönotto ja ylläpito > Saavutukset) Lisää saavutuksia.
Saavutusten tuominen
Näin lisäät peliin kerralla useita saavutuksia:
1. Luo saavutukset sisältävä ZIP-tiedosto.
1. Lataa tiedosto.
Lue lisää ZIP-tiedostoista ZIP-tiedostojen ohjeista.
Näin tuot saavutuksia:
- Valitse peli Google Play Consolesta.
- Valitse Playn pelipalvelut – Saavutukset -sivulta (Kasvu > Playn pelipalvelut > Käyttöönotto ja ylläpito > Saavutukset) Tuo saavutuksia.
- Klikkaa Tuo saavutuksia ‐sivulta Lataa.
- Valitse ladattava ZIP-tiedosto.
- Valitse Tallenna luonnoksena.
- Kun olet tuonut saavutukset, sinun täytyy julkaista peli.
Pelin julkaiseminen
Saavutuksen muokkaaminen
Jos haluat muokata jo luotua saavutusta, valitse se Google Play Consolen Saavutukset-välilehdeltä. Näet tässä vaiheessa saman lomakkeen, jota käytit luodessasi saavutusta. Voit muokata kaikkia kenttiä tarpeen mukaan.
Kun olet valmis muokkaamaan saavutusta, klikkaa Tallenna luonnoksena ‐painiketta. Muokattu saavutus näkyy nyt "Valmis testaukseen" -tilassa, ja voit testata sitä. Jos se toimii oikein, valitse avattavasta listasta Julkaise uudelleen. Tämä julkaisee pelin ja kaikki päivitetyt saavutukset uudelleen.
Huom. Kun saavutus on julkaistu, sen alkutila (piilotettu tai näkyvissä) ja tyyppi (vaiheittainen tai vakio) ovat kiinteät, eikä niitä voi muuttaa.
Muokkauksen kumoaminen
Saavutuksen poistaminen
Kun saavutus on julkaistu, sitä ei voi poistaa.
Voit poistaa ennakkoon julkaistun saavutuksen vain klikkaamalla kyseistä saavutusta koskevan lomakkeen alareunasta Poista.
Saavutuksen nollaaminen
Voit nollata pelaajien edistymisen datan vain luonnostilassa olevien saavutusten osalta.
- Voit nollata saavutukset Google Play Consolessa klikkaamalla tapahtuman lomakkeen alareunasta Nollaa saavutuksen edistyminen ‐painiketta.
- Jos haluat nollata saavutusdatan ohjelmallisesti, kutsu Management APIn Achievements-menetelmiä.
Kuvakkeita koskevat ohjeet
Kuvakkeet on luotava 512 x 512 px:n PNG-, JPEG- tai JPG-tiedostoina. Sinun tarvitsee toimittaa meille vain lukitun saavutuksen kuvake. Luomme näkyvissä olevalle kuvakkeelle automaattisesti harmaasävyisen version. Siksi suosittelemme, että saavutusten kuvakkeissa on värikkäitä elementtejä, jotta käyttäjät voivat erottaa näkyvissä olevat ja avatut saavutukset toisistaan.
Kun saavutuskuvake näkyy Androidin ilmoitusruudussa, kuvakkeen päällä on ympyrä ja sen ulkokulmat on piilotettu. Varmista, että kuvake näyttää hyvältä näissäkin olosuhteissa.
Esimerkki saavutuksen kuvakkeesta
Samaa kuvaketta käytetään kaikissa kieliversioissa, joten kuvakkeeseen ei kannata lisätä tekstiä tai lokalisoitua sisältöä.
ZIP-tiedostojen ohjeet
Voit tuoda useita saavutuksia kerralla ZIP-tiedostona. Katso tarkat tiedostonimet taulukosta:
|
Tiedostonimi |
Pakollinen tai valinnainen |
Hyväksyttävät arvot |
|
|
Pakollinen |
Kunkin saavutuksen metadata. Katso Määritteet. |
|
|
Valinnainen |
Sisältää saavutusten nimien ja kuvausten käännökset. |
|
|
Valinnainen |
Mäppää saavutukset kuvaketiedostoihin. |
|
Valinnainen |
Kuvakkeet PNG-, JPEG- tai JPG-muodossa. |
ZIP-tiedostojen vaatimukset:
- Ei alihakemistoja.
- Yksilölliset tiedostonimet.
- Vain CSV-, PNG-, JPEG- ja JPG-tiedostoja.
- CSV-tiedostossa ei saa olla otsikkoriviä.
- Kunkin tiedoston on oltava alle 1 Mt:n kokoinen.
- Tiedostojen kokonaismäärän on oltava alle 203.
- ZIP-tiedoston kokonaiskoon on oltava alle 200 Mt.
AchievementsMetadata.csv-tiedoston muoto
AchievementsMetadata.csv-tiedosto sisältää kunkin saavutuksen metadatan. Tiedot on ilmoitettava pilkuilla erotettuina arvoina seuraavassa järjestyksessä:
Kentät on kuvattu seuraavassa taulukossa:
|
CSV-sarakkeiden otsikot |
Pakollinen tai valinnainen |
Hyväksyttävät arvot |
|
Name (Nimi) |
Pakollinen |
Enintään 100 merkkiä |
|
Description (Kuvaus) |
Valinnainen |
Enintään 500 merkkiä |
|
Incremental Value (Vaiheittainen arvo) |
Valinnainen |
Oikein vai väärin |
|
Steps Needed (Tarvittavat vaiheet) |
Pakollinen, jos Incremental Value on "Tosi". |
Luku (ei murtolukuja tai desimaaleja) |
|
Initial State (Alkutila) |
Pakollinen |
Piilotettu tai Näkyvissä |
|
Points (Pisteet) |
Pakollinen |
Arvon on oltava 5:llä jaollinen välillä 5–200. |
|
List Order (Järjestys listassa) |
Valinnainen |
Luku (ei murtolukuja tai desimaaleja, ja suurempi kuin nolla) |
AchievementsMetadata.csv-tiedoston vaatimukset:
- Kullakin rivillä on oltava seitsemän arvoa. Jos haluat jättää arvon pois, jätä kenttä tyhjäksi.
- Name- ja Description-kenttiä käytetään oletuskielenä.
- Name-kentän on oltava yksilöllinen kaikissa saavutuksissa.
- Seuraavat kentät eivät saa sisältää pilkkuja: Name ja Description.
Esimerkki AchievementsMetadata.csv-tiedostosta:
Achievement1,,True,100,Hidden,5,20
Achievement2,,False,,Revealed,10,30
AchievementsLocalizations.csv-tiedoston muoto
AchievementsLocalizations.csv on valinnainen tiedosto. Se sisältää kaiken datan, jota tarvitaan kunkin saavutuksen kuvaamiseen eri kielillä. Saavutukset käännetään pelin kieli- ja maa-asetusten mukaisesti.
Tiedot on ilmoitettava pilkuilla erotettuina arvoina seuraavassa järjestyksessä:
Kentät on kuvattu seuraavassa taulukossa:
|
CSV-sarakkeiden otsikot |
Pakollinen tai valinnainen |
Kuvaus |
Hyväksyttävät arvot |
|
Name (Nimi) |
Pakollinen |
Nimen on vastattava |
Enintään 100 merkkiä |
|
Localized name (Lokalisoitu nimi) |
Pakollinen |
Saavutuksen lokalisoitu nimi |
Enintään 100 merkkiä |
|
Localized description (Lokalisoitu kuvaus) |
Valinnainen |
Saavutuksen lokalisoitu kuvaus määritetyllä kieli- ja maa-asetuksella |
Enintään 500 merkkiä |
|
Locale (Kieli- ja maa-asetus) |
Pakollinen |
Kieli- ja maa-asetuskoodi, kuten fi-FI |
Lisää pelin käännökset ennen kuin määrität kieli- ja maa-asetuksen. Huomaa, ettet voi määrittää oletuskieli- ja maa-asetusta. Tuetut kieli- ja maa-asetukset löytyvät tuettujen kielten listalta. |
AchievementsLocalizations.csv-tiedoston vaatimukset:
- Pelin saavutusten nimien on oltava yksilöllisiä kieli- ja maa-asetuskohtaisesti. Jos peli esimerkiksi tukee sekä en-US- että fr-FR-kieliversioita, saavutuksen nimi voi olla "Achievement1" sekä en-US-versiossa että fr-FR-versiossa.
- Kullakin rivillä on oltava neljä arvoa. Jos haluat jättää Localized description -arvon pois, jätä kenttä tyhjäksi.
Esimerkki AchievementsLocalizations.csv-tiedostosta:
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
AchievementsIconMappings.csv-tiedoston muoto
AchievementsIconMappings.csv-tiedosto on valinnainen tiedosto, jonka avulla voit mäpätä saavutukset tiettyyn kuvakkeeseen. Tiedot on ilmoitettava pilkuilla erotettuina arvoina seuraavassa järjestyksessä:
Kentät on kuvattu seuraavassa taulukossa:
|
CSV-sarakkeiden otsikot |
Pakollinen tai valinnainen |
Kuvaus |
|
Name (Nimi) |
Pakollinen |
Nimen on vastattava |
|
Icon filename (Kuvakkeen tiedostonimi) |
Pakollinen |
Kuvaketiedoston nimi |
AchievementsIconMappings.csv-tiedoston vaatimukset:
- Kullakin rivillä on oltava kaksi arvoa.
- Kuvaketiedostot voivat olla vain PNG- tai JPEG-muodossa.
Esimerkki AchievementsIconMappings.csv-tiedostosta:
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
Kuvaketiedostot
AchievementsIconMappings.csv-tiedostossa mainittujen kuvakkeiden on oltava tuomassasi ZIP-arkistossa. Lue lisää kuvakeohjeista.Käännösten lisääminen saavutuksiin
Voit lisätä omat käännöksesi peliisi liittyville saavutuksille. Varmista ensin, että olet seurannut pelin käännösten lisäämistä koskevia ohjeita.
Voit lisätä pelille käännöksiä kahdella tavalla:
- Tuo saavutuksia ‐vaihtoehdon avulla voit ladata useiden uusien saavutusten käännökset kerralla. Tällä vaihtoehdolla ei voi ladata käännöksiä aiemmin luoduille saavutuksille.
- Voit lisätä käännöksen kullekin pelin saavutukselle. Näin lisäät omat käännökset saavutuksille:
- Avaa Google Play Consolessa pelin Saavutukset-välilehti ja valitse jokin saavutus.
- Valitse saavutusten tietosivulta sen kielen välilehti, jonka olet aiemmin lisännyt Pelin tiedot ‐välilehdelle.
- Muokkaa kyseisen kielen saavutuksen tietosivulla olevaa lomaketta ja lisää siihen kyseisen saavutuksen käännökset.
- Tallenna saavutuksen tiedot klikkaamalla Tallenna.
Kun lisäät tulostaulukot, pelaajat voivat vertailla tuloksia ystäviensä kanssa ja kilpailla huippupelaajien kanssa.
Huom. Tulostaulukoiden tuloksia ei voi nollata, mutta voit poistaa tai piilottaa tulostaulukon milloin tahansa.
Jos haluat piilottaa tulostaulukossa olevat epäilyttävät tulokset, voit ottaa tulostaulukoiden peukaloinnin eston käyttöön siirtymällä Play Consolessa pelisi Tulostaulukot-sivulle.
Tulostaulukon luominen
Näin voit luoda tulostaulukon uudelle ja julkaisemattomalle pelille:
- Valitse peli Google Play Consolesta.
- Valitse Kasvu > Playn pelipalvelut > Käyttöönotto ja ylläpito > >Tulostaulukot ja klikkaa Luo pistetaulukko ‐painiketta.
- Täytä tulostaulukkoon tarvittavat tiedot.
- Valitse Tallenna luonnos, niin tulostaulukkosi siirtyy "Luonnos"-tilaan.
- Kun julkaiset pelin, kaikki pelin tulostaulukot julkaistaan sen mukana.
Tulostaulukon luominen julkaistulle pelille
Jos haluat luoda uuden tulostaulukon jo julkaistulle pelille, seuraa yllä olevia ohjeita. Lue lisää pelin päivitetyn version testaamisesta pelimuutosten julkaisemista koskevasta artikkelista.
Kun olet testannut tulostaulukkoa ja tyytyväinen siihen, voit julkaista pelin uudelleen uusien tulostaulukoiden kanssa, jolloin ne julkaistaan kaikille.
Tulostaulukon muokkaaminen
Jos haluat muokata jo luotua tulostaulukkoa, klikkaa sitä Google Play Consolen Tulostaulukot-välilehdeltä. Näet tässä vaiheessa saman lomakkeen, jota käytit luodessasi tulostaulukkoa. Voit muokata kaikkia kenttiä tarpeen mukaan.
Kun olet valmis muokkaamaan tulostaulukkoa, klikkaa Tallenna luonnoksena ‐painiketta. Muokattu tulostaulukko on luonnostilassa, jossa voit testata sitä.
Jos tulostaulukko toimii oikein, valitse lomakkeen yläreunasta Julkaise muutokset. Tämän jälkeen voit julkaista pelin ja kaikki päivitetyt tulostaulukot uudelleen.
Muokkauksen kumoaminen
Tulostaulukon poistaminen
Voit poistaa tulostaulukoita, joiden tila on "Luonnos" tai jotka on julkaistu. Jos haluat poistaa tulostaulukon Google Play Consolesta, siirry tulostaulukkolomakkeeseen ja klikkaa yläreunasta Poista tulostaulukko.
Vaihtoehtoisesti voit kutsua Players.hide-ominaisuutta, jos haluat piilottaa pelaajan tulostaulukon sovelluksesta.
Tulostaulukon nollaaminen
Voit nollata pelaajien edistymisen datan vain luonnostilassa olevien tulostaulukoiden osalta.
- Jos haluat nollata tulostaulukon Google Play Consolessa, klikkaa tapahtuman lomakkeen yläreunasta Nollaa edistyminen.
- Voit nollata tulostaulukon datan ohjelmallisesti kutsumalla Management APIn Scoresmethods-menetelmiä.
Käännösten lisääminen tulostaulukoihin
Voit lisätä omat käännöksesi peliisi yhdistetyille tulostaulukoille. Varmista ensin, että olet seurannut pelin käännösten lisäämistä koskevia ohjeita. Sinun on myös luotava peliin vähintään yksi tulostaulukko.
Jos haluat lisätä omia käännöksiä tulostaulukoille, avaa pelisi Tulostaulukot-välilehti Google Play Consolessa ja valitse haluamasi tulostaulukko. Klikkaa tulostaulukon tietosivulta sen kielen välilehteä, jonka olet aiemmin lisännyt Pelin tiedot ‐välilehdellä. Muokkaa kyseisen kielen tulostaulukon tietosivulla olevaa lomaketta ja lisää siihen kyseisen tulostaulukon käännökset. Tallenna käännös klikkaamalla Tallenna.
Pisteiden piilottaminen tulostaulukosta
Google Play pelipalvelut tarjoaa tulostaulukon peukaloinnin eston, joka tarkistaa mahdollisesti peukaloidut tulokset ja piilottaa ne automaattisesti. Ominaisuus on käytettävissä vain Android-peleissä.
Peukaloinnin esto on oletuksena käytössä uusissa Android-pelille luomissasi tulostaulukoissa, mutta se on pois päältä aiemmin luoduissa tulostaulukoissa. Näin voit ottaa peukaloinnin eston käyttöön jo julkaistuissa tulostaulukoissa:
- Avaa Google Play Consolessa Pelipalvelut-välilehti ja valitse peli listalta.
- Avaa Tulostaulukot-välilehti ja valitse tulostaulukko, jolle haluat ottaa käyttöön peukaloinnin eston.
- Laita Ota peukaloinnin esto käyttöön tulostaulukossa ‐asetus päälle.
- Klikkaa Tallenna ja jatka.
- Julkaise peli.
Kun peukaloinnin esto on otettu käyttöön tulostaulukossa Google Play Consolessa, voi mennä 24 tuntia, ennen kuin ominaisuus tulee voimaan. Ennen peukaloinnin eston käyttöönottoa lähetettyjä pisteitä ei piiloteta takautuvasti.
Joissakin tilanteissa saatat haluta poistaa peukaloinnin eston käytöstä (esimerkiksi jos pelisi toimii Androidin lisäksi myös verkossa ja jakaa tulostaulukoita näillä alustoilla).
Saat ohjeita tallennettujen pelien käyttöönottoon Google Developers ‑sivustolta.
Tallennettujen pelien käyttöönotto
Näin voit ottaa Tallennetut pelit ‐palvelun käyttöön Play Consolessa:
- Valitse peli Google Play Consolesta.
- Valitse Playn pelipalvelujen määritys ‐sivulta (Kasvu > Playn pelipalvelut > Käyttöönotto ja ylläpito > Määritys) Muokkaa asetuksia.
- Laita Tallennetut pelit ‐asetus PÄÄLLE.
- Klikkaa Tallenna.
Kun olet tehnyt nämä vaiheet, voi mennä 24 tuntia, ennen kuin Google Playn pelipalvelut aktivoivat Tallennetut pelit -palvelun pelissäsi. Jos haluat testata Tallennetut pelit ‐palvelua heti, tyhjennä data manuaalisesti testilaitteesi Google Play Palvelut ‐sovelluksesta.
Voit tyhjentää välimuistiin tallennetun datan Android-laitteella avaamalla Asetukset > Sovellukset > Google Play Palvelut, klikkaamalla Hallinnoi tallennustilaa ja valitsemalla Poista kaikki data.
Lue lisää Tallennetut pelit ‐palvelusta Tallennettujen pelien pelioppaasta.
Käännösten lisääminen
Voit lisätä omat käännöksesi pelin tiedoille, esimerkiksi julkisesti näkyvälle nimelle, pelin kuvaukselle ja graafiselle sisällölle. Voit myös määrittää omat käännökset peliisi liittyville saavutuksille ja tulostaulukoille.
Näin lisäät omia käännöksiä pelin tietoihin:
- Valitse peli Google Play Consolesta.
- Siirry Playn pelipalvelujen määritys ‐sivulle (Kasvu > Playn pelipalvelut > Käyttöönotto ja ylläpito > Määritys).
- Valitse Muokkaa asetuksia.
- Valitse Ylläpidä käännöksiä > Ylläpidä omia käännöksiä.
- Valitse kielet, joilla lisäät käännöksiä, ja vahvista valinta klikkaamalla Käytä. Valitsemasi kielet tulevat saataville Ominaisuudet-sivun kielivalitsimella.
- Valitse muokattava kieli kielivalitsimesta ja lisää sitten lomakkeeseen julkisesti näkyvän nimen, kuvauksen ja graafisten elementtien käännökset.
- Tallenna käännetyt pelin tiedot klikkaamalla Tallenna muutokset.
Lisätietoa saavutusten ja tulostaulukoiden käännösten lisäämisestä on saavutusten ja tulostaulukoiden oppaissa.
Kun Playn pelipalvelut näyttää pelin tietoja, tulostaulukoita ja saavutuksia, se käyttää pelin tukemaa kieltä, joka on lähimpänä käyttäjän pyytämää kieltä. Jos esimerkiksi käyttäjän laitteen kieliasetuksena on ranska (Kanada) (fr-CA), mutta peli tukee vain englantia (Yhdysvallat) (en-US) ja ranskaa (Ranska) (fr-FR), Playn pelipalvelut valitsee fr-FR-kieliasetuksen, koska se on lähinnä käyttäjän valitsemaa kieltä.
Muokkauslupien myöntäminen käyttäjille
Voit automatisoida sovelluksen määrittämisen ja integroida julkaisuja automaattisiin työkaluihin ja prosesseihin käyttämällä Google Play Games Services Publishing APIa. Näin voit ottaa Google Play Games Services Publishing APIn käyttöön Play Consolessa:
- Avaa Google Play Console.
- Valitse Määritys
API-pääsyoikeudet.
- Luo linkitetty projekti, jos et ole jo tehnyt niin.
- Klikkaa Käytössä-painiketta Pelien määritys-API ‑kohdan vieressä.
Useiden käyttäjien ylläpito
Jos useat käyttäjät ylläpitävät pelejä kehittäjätililläsi, sinun on ylläpidettävä lupia Play Consolen Käyttäjät ja luvat ‑sivun kautta.