Функције Google Play услуга игара

Помоћу Google Play услуга игара можете да додате играма интересантне функције за друштвене мреже и више играча.

Изаберите функцију у наставку да бисте сазнали основне податке о њима и пронашли документацију о примени Google Play услуга игара.

Започните

Интегришите пакет за развој софтвера за Google Play услуге игара

Да бисте сазнали како да интегришете пакет за развој софтвера за Google Play услуге игара, посетите сајт Google Developers да бисте пронашли упутства и примере како да започнете.

Направите унос за игру

Да бисте користили Google Play услуге игара, треба да направите унос за игру у Play конзоли. Унос за игру је одвојен од странице апликације Унос у Продавници.

Ево како можете да додате нов унос за игру:

1. Отворите Google Play конзолу.
2. Идите на Подешавање > Пројекти игара.
3. У горњем десном углу екрана кликните на Додај нову игру.

Функције

Достигнућа

Помоћу достигнућа можете да задржите играче тако што ћете додати награде за остваривање постављених циљева у игри. Играчи могу да добију искуствене поенe (XP поене) за остваривање достигнућа у игри.

Посетите сајт Google Developers да бисте сазнали више о достигнућима.

Напомена: Када објавите достигнуће, више не можете да га избришете.

Додајте достигнућа

Постоје два начина да први пут направите достигнућа помоћу Google Play конзоле:

• Направите достигнуће: Додајте дефиниције и метаподатке за свако достигнуће једно по једно.
• Увезите достигнућа Увезите дефиниције и друге метаподатке за више достигнућа заједно у једном кораку.

Напомена: Користите API-је да бисте откључали достигнућа за пријављеног играча. Тиме ћете играчу открити сва скривена достигнућа.

Направите достигнуће

Да бисте направили достигнуће за нову и необјављену игру, обавите следеће кораке помоћу Google Play конзоле:

1. У Google Play конзоли изаберите игру.
2. У Услугама Play игара – страница Достигнућа (Раст > Услуге Play игара > Подешавање и управљање > Достигнућа) изаберите Направи достигнуће.
3. На страници Додајте достигнућа попуните образац.
4. Кликните на Сачувај као радну верзију.

Када направите достигнуће, треба да објавите игру.

Додајте још достигнућа

Ако већ имате постојећа достигнућа и желите да додате још:

1. У Google Play конзоли изаберите игру.

2. У Услугама Play игара – страница Достигнућа (Раст > Услуге Play игара > Подешавање и управљање > Достигнућа) изаберите Додајте достигнућа.

Увезите достигнућа

Да бисте одједном додали више достигнућа у игру, пратите следеће кораке:

1. Направите ZIP фајл који садржи достигнућа.

1. 1 Отпремите фајл.

Више информација о ZIP фајлу потражите у чланку Смернице за ZIP фајлове.

Да бисте увезли достигнућа:

1. У Google Play конзоли изаберите игру.
2. У Услугама Play игара – страница Достигнућа (Раст > Услуге Play игара > Подешавање и управљање > Достигнућа) изаберите Увезите достигнућа.
3. На страници Увезите достигнућа кликните на Отпреми.
4. Изаберите ZIP фајл за отпремање.
5. Кликните на Сачувај као радну верзију.
6. Када увезете достигнућа, морате да објавите игру.

Објавите игру

Када тестирате и објавите игру, сва достигнућа игре се објављују заједно са њом.

Измените достигнуће

Да бисте изменили достигнуће које сте већ направили, изаберите га на картици Достигнућа у Google Play конзоли. Тада ћете видети исти образац који сте користили када сте први пут направили достигнуће и можете да измените било које поље по потреби.

Када завршите са изменама достигнућа, кликните на дугме Сачувај као радну верзију. Достигнуће које сте изменили ће бити у фази Спремно за тестирање и моћи ћете да га тестирате. Ако исправно ради, изаберите Поново објави у падајућем менију. Овим се игра поново објављује, заједно са свим ажурираним достигнућима.

Напомена: Када се достигнуће објави, његов почетни статус (сакривен или откривен) и тип (инкрементални или стандардни) су фиксни и не могу да се мењају.

Опозовите измену

Ако одлучите да вам се тренутно достигнуће не свиђа и желите да се вратите на претходно достигнуће, изаберите Врати у падајућем менију у Google Play конзоли и сва достигнућа ће се вратити на претходно објављену верзију.

Избришите достигнуће

Када објавите достигнуће, не можете да га избришете.

Достигнуће у статусу пре објављивања можете да избришете само кликом на дугме Избриши у дну обрасца за то достигнуће.

Ресетујте достигнуће

Податке о напретку играча можете да ресетујете само за радне верзије достигнућа.

• Да бисте ресетовали достигнућа у Google Play конзоли, кликните на дугме Ресетуј напредак достигнућа у дну обрасца за тај догађај.
• Да бисте програмски ресетовали податке о достигнућима, покрените методедостигнућа Management API-ја.

Смернице за иконе

Иконе треба да направите као PNG, JPEG или JPG фајлове димензија 512×512. Треба да нам доставите само икону за откључано достигнуће. Аутоматски ћемо генерисати верзију у сивим нијансама за икону откривеног достигнућа. Зато препоручујемо да иконе достигнућа садрже разнобојне елементе како би корисници могли да разликују откривена и откључанa достигнућа.

Када се икона достигнућа приказује у Android повратној поруци, икона је прекривена кругом, а њени спољни углови су сакривени. Уверите се да икона и даље изгледа добро у тим околностима.

Пример иконе достигнућа.

Иста икона се користи на свим локалитетима, па вам препоручујемо да не постављате текст или локализовани садржај у икону.

Смернице за ZIP фајлове

Можете да увезете више достигнућа одједном помоћу ZIP фајла. Погледајте табелу да бисте видели тачне називе фајлова које треба да користите у ZIP фајлу:

Назив фајла	Обавезно или опционално	Прихваћене вредности
AchievementsMetadata.csv	Обавезно	Метаподаци за свако достигнуће. Погледајте чланак Атрибути.
AchievementsLocalizations.csv	Опционално	Пружа преводе за називе и описе достигнућа.
AchievementsIconMappings.csv	Опционално	Мапира достигнућа са фајловима икона.
Фајлови икона	Опционално	Иконе у PNG, JPEG или JPG формату.

Услови за ZIP фајл:

• Без поддиректоријума.
• Јединствени називи фајлова.
• Само CSV, PNG, JPEG или JPG фајлови.
• CSV фајл не сме да има ред заглавља.
• Сваки фајл мора да буде мањи од 1 MB.
• Укупан број фајлова мора да буде мањи од 203.
• Укупна величина ZIP фајла мора да буде мања од 200 MB.

Формат AchievementsMetadata.csv

Фајл AchievementsMetadata.csv садржи метаподатке за свако достигнуће. Треба да садржи информације као вредности раздвојене зарезима следећег редоследа:

Назив,Опис,Инкрементална вредност,Неопходни кораци,Почетни статус,Поени,Редослед листе

Та поља су описана у следећој табели:

Заглавља колона CSV фајла	Обавезно или опционално	Прихваћене вредности
Назив	Обавезно	Максимално 100 знакова
Опис	Опционално	Максимално 500 знакова
Инкрементална вредност	Опционално	Тачно или нетачно
Потребни кораци	Обавезно ако је инкрементална вредност Тачно.	Број (без разломака или децимала)
Почетни статус	Обавезно	Скривено или откривено
Поени	Обавезно	Број који је дељив са 5, а вредност мора да буде између 5 и 200
Редослед листе	Опционално	Број (без разломака или децимала и већи од нуле)

Услови за фајл AchievementsMetadata.csv:

• Сваки ред мора да има седам вредности. Ако желите да изоставите вредност, оставите празно.
• Поља Назив и Опис се користе као подразумевани локални стандард.
• Поље Назив треба да буде јединствено за сва достигнућа.
• Следећа поља не смеју да садрже зарезе: Назив и Опис.

Пример фајла AchievementsMetadata.csv:

Достигнуће1,,Тачно,100,Сакривено,5,20

Достигнуће2,,Нетачно,,Откривено,10,30

Формат AchievementsLocalizations.csv

Фајл AchievementsLocalizations.csv је опционални фајл који подешава све податке који су потребни за опис сваког достигнућа корисницима на различитим локалитетима. Достигнућа се преводе у складу са локалитетима наведеним за игру.

Треба да садржи информације као вредности раздвојене зарезима следећег редоследа:

Назив, локализовани назив, локализовани опис, локални стандард

Та поља су описана у следећој табели:

Заглавља колона CSV фајла	Обавезно или опционално	Опис	Прихваћене вредности
Назив	Обавезно	Мора да се подудара са колоном Назив у фајлу AchievementsMetadata.csv.	Максимално 100 знакова
Локализован назив	Обавезно	Локализовани назив достигнућа.	Максимално 100 знакова
Локализовани опис	Опционално	Локализовани опис достигнућа на наведеном локалном стандарду.	Максимално 500 знакова
Локалитет	Обавезно	Кôд локалног стандарда, нпр. en-US.	Додајте преводе за игру пре него што наведете локални стандард. Имајте у виду да не можете да наведете подразумевани локални стандард. Кодове подржаних локалних стандарда можете да пронађете на листи подржаних језика.

Услови за фајл AchievementsLocalizations.csv:

• Називи достигнућа у игри морају да буду јединствени по локалном стандарду. На пример, ако игра подржава локалитете en-US и fr-FR, достигнуће под називом „Achievement1“ за en-US може да се зове и „Achievement1“ за fr-FR.
• Сваки ред треба да има четири вредности. Ако желите да изоставите вредност Локализовани опис, оставите поље празно.

Пример фајла 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

Формат AchievementsIconMappings.csv

Фајл AchievementsIconMappings.csv је опционални фајл који се користи за мапирање достигнућа са датом иконом. Треба да садржи информације као вредности раздвојене зарезима следећег редоследа:

Назив, назив фајла иконе

Та поља су описана у следећој табели:

Заглавља колона CSV фајла	Обавезно или опционално	Опис
Назив	Обавезно	Мора да се подудара са колоном Назив у фајлу AchievementsMetadata.csv.
Назив фајла иконе	Обавезно	Назив фајла иконе.

Услови за фајл AchievementsIconMappings.csv:

• Сваки ред треба да има две вредности.
• Фајлови икона могу да буду само у PNG или JPEG формату.

Пример фајла AchievementsIconMappings.csv:

Важеће достигнуће,важеће-достигнуће-икона.png

Инкрементално достигнуће,инкрементално-достигнућe-икона.jpeg

Без описа,без-описа-икона.png

Скривено почетно стање,скривено-почетно-стање-икона.png

Велика вредност у поенима,велика-вредност-у-поенима-икона.jpeg

Фајлови икона

Иконе које наводите у фајлу AchievementsIconMappings.csv морају да постоје у актуелној ZIP архиви коју увозите. Више информација потражите у чланку Смернице за иконе.

Додајте преводе за достигнућа

Можете да наведете сопствене преводе за достигнућа која су повезана са игром. Пре тога обавезно обавите кораке описане у чланку Додавање превода за игру.

Постоје два начина да додате преводе за игру:

• Помоћу опције Увези достигнућа можете да отпремите преводе за много нових достигнућа одједном. Не можете да користите ову опцију за отпремање превода за већ постојећа достигнућа.
• Можете да додате преводе за свако достигнуће у игри. Да бисте додали свој превод за свако достигнуће:
  1. У Google Play конзоли отворите картицу Достигнућа за игру, па изаберите постојеће достигнуће.
  2. На страници са детаљима о достигнућима изаберите картицу за језик који сте раније додали на картици Детаљи о игри.
  3. На страници са детаљима о достигнућу за тај језик измените образац помоћу превода за то достигнуће.
  4. Кликните на Сачувај да бисте сачували детаље о преведеном достигнућу.

Табеле са резултатима

Помоћу табела са резултатима омогућавате играчима да упоређују своје резултате са резултатима пријатеља и да се такмиче са најуспешнијим играчима.

Напомена: Резултати на ранг листи не могу да се ресетују, али у сваком тренутку можете да избришете или сакријете ранг листу.

Да бисте сакрили сумњиве резултате на постојећим ранг листама, можете да укључите заштиту од неовлашћених измена ранг листа на страници Ранг листе за игру у Play конзоли.

Направите ранг листу

Да бисте направили ранг листу за нову и необјављену игру, обавите следеће кораке:

1. У Google Play конзоли изаберите игру.
2. Идите на Раст > Услуге Play игара > Подешавање и управљање > Ранг листе, па кликните на дугме Направи ранг листу.
3. Попуните информације неопходне за ову ранг листу.
4. Кликните на Сачувај као радну верзију и ранг листа ће бити доступна у статусу Радна верзија.
5. Када објавите игру, све ранг листе игре се објављују уз њу.

Направите ранг листу за објављену игру

Да бисте направили додатну ранг листу за игру која је већ објављена, пратите исте кораке као изнад. Више информација о тестирању ажуриране верзије игре потражите у чланку Објављивање промена игре.

Када тестирате ранг листу и будете задовољни њом, можете поново да објавите игру са новим ранг листама и оне ће бити објављене широм света.

Измените ранг листу

Да бисте изменили ранг листу коју сте већ направили, кликните на ранг листу на картици Ранг листе у Google Play конзоли. Видећете исти образац који сте користили при првом прављењу ранг листе и моћи ћете да мењате поља по потреби.

Када завршите са изменом ранг листе, кликните на дугме Сачувај као радну верзију. Ранг листа коју сте изменили ће имати статус Радна верзија, што вам омогућава да је тестирате.

Ако све функционише како треба, изаберите Објави промене у оквиру у врху обрасца ранг листе и моћи ћете поново да објавите игру, заједно са свим ажурираним ранг листама.

Опозовите измену

Ако одлучите да вам се не свиђа ранг листа коју сте управо изменили и желите да се вратите на претходну верзију, само изаберите Врати у оквиру у врху обрасца Ранг листа. Ранг листа се враћа на већ објављену верзију.

Избришите ранг листу

Можете да избришете ранг листе које су у статусу Радна верзија или које су објављене. Да бисте избрисали ранг листу у Google Play конзоли, идите на образац за ранг листу и кликните на Избриши ранг листу у врху обрасца.

Можете и да покренете Players.hide да бисте сакрили ранг листу играча у апликацији.

Ресетујте ранг листу

Податке о напретку играча можете да ресетујете само за радне верзије ранг листа.

• Да бисте ресетовали ранг листе у Google Play конзоли, кликните на Ресетуј напредак у врху обрасца за тај догађај.
• Да бисте програмски ресетовали податке о ранг листи, покрените Management API Scoresmethods.

Додајте преводе за ранг листе

Можете да наведете сопствене преводе за ранг листе које су повезане са игром. Пре тога обавезно обавите кораке описане у чланку Додавање превода за игру. Морате и да направите бар једну ранг листу за игру.

Да бисте додали сопствене преводе за ранг листе, отворите картицу Ранг листе за игру у Google Play конзоли, па изаберите постојећу ранг листу. На страници са детаљима о ранг листи кликните на картицу за језик који сте претходно додали на картици Детаљи игре. На страници са детаљима о ранг листи за тај језик измените образац помоћу превода за ту ранг листу. Кликните на Сачувај да бисте сачували детаље о преведеној ранг листи.

Сакријте резултате на ранг листи

Услуге Google Play игара пружају функцију заштите од неовлашћених измена ранг листе која проверава да ли постоје резултати за које се сумња да су измењени и аутоматски их скрива. Ова функција је доступна само за Android игре.

Заштита од неовлашћених измена је подразумевано омогућена за нове ранг листе које направите за Android игру, али је онемогућена за постојеће ранг листе. Да бисте омогућили заштиту од неовлашћених измена за постојеће ранг листе које су већ објављене, пратите следеће кораке:

1. У Google Play конзоли отворите картицу Услуге игара, па изаберите игру са листе.
2. Отворите картицу Ранг листа, па изаберите инстанцу ранг листе за коју желите да омогућите заштиту од неовлашћених измена.
3. Укључите опцију Омогући заштиту ранг листе од неовлашћених измена.
4. Кликните на Сачувај и наставите.
5. Објавите игру.

Када омогућите заштиту од неовлашћених измена за ранг листу у Google Play конзоли, може да прође до 24 сата пре него што ова функција ступи на снагу. Резултати послати пре него што сте омогућили заштиту од неовлашћених измена не скривају се ретроактивно.

У неким ситуацијама ћете можда желети да онемогућите заштиту од неовлашћених измена (на пример, ако се игра покреће и на вебу поред Android-а и дели ранг листе на тим платформама).

Сачуване игре

Помоћу сачуваних игара олакшавате играчима да чувају свој напредак. Напредак играча и метаподаци се синхронизују на више уређаја на којима се користе Google Play услуге игара.

Посетите сајт Google Developers да бисте сазнали како да примените сачуване игре.

Омогућите сачуване игре

Да бисте омогућили услугу Сачуване игре, обавите следеће кораке у Play конзоли:

1. У Google Play конзоли изаберите игру.
2. На страници Услуге Play игара – конфигурација (Раст > Услуге Play игара > Подешавање и управљање > Конфигурација) изаберите Измените својства.
3. Подесите опцију Сачуване игре на УКЉУЧЕНО.
4. Кликните на Сачувај.

Када обавите кораке, може да прође до 24 сата док услуге Google Play игара не активирају услугу Сачуване игре за вашу игру. Ако желите одмах да тестирате услугу Сачуване игре, ручно обришите податке у апликацији Google Play услуге на уређају за тестирање.

Да бисте обрисали кеширане податке на Android-у, отворите Подешавања > Апликације > Google Play услуге, кликните на Управљајте простором, па на Обриши све податке.

Више информација о услузи Сачуване игре потражите у водичу за игре Сачуване игре.

Додајте преводе

Можете да подесите сопствене преводе за детаље о игри, укључујући име за приказ, опис игре и графички материјал. Можете и да наведете сопствене преводе за достигнућа и ранг листе повезане са игром.

Да бисте додали сопствене преводе за детаље игре:

1. У Google Play конзоли изаберите игру.
2. Идите на страницу Услуге Play игара – конфигурација (Раст > Услуге Play игара > Подешавање и управљање > Конфигурација).
3. Изаберите Измени својства.
4. Изаберите Управљајте преводима > Управљајте својим преводима.
5. Изаберите језике за које ћете навести преводе, па кликните на Примени да бисте потврдили избор. На страници Својства језици које сте изабрали постају доступни у бирачу језика.
6. Изаберите језик који желите да измените у бирачу језика, па измените образац помоћу превода за име за приказ, опис и графички материјал.
7. Кликните на Сачувај промене да бисте сачували преведене детаље о игри.

Више информација о додавању превода за достигнућа и ранг листе потражите у водичима за достигнућа и ранг листе.

Када приказују детаље игре, ранг листу и стрингове достигнућа, услуге Play игара користе језик који подржава игра који је најближи језику који је затражио корисник. На пример, ако је подешавање језика уређаја корисника подешено на француски (Канада) (fr-CA), али игра подржава само енглески (САД) (en-US) и француски (Француска) (fr-FR), услуге Play игара бирају стрингове fr-FR за приказивање јер је то језик који највише одговара.

Дајте корисницима дозволе за измене

Да бисте изменили подешавања услуге Play игара у Play конзоли, тим мора да има одговарајуће дозволе за управљање услугама Play игара. Више информација о дозволама у Play конзоли потражите у чланку Додајте кориснике налога програмера и управљајте дозволама.

Google Play Game Services Publishing API

Можете да користите Google Play Games Services Publishing API да бисте аутоматизовали конфигурисање апликација и интегрисали верзије у постојеће аутоматизоване алатке и процесе. Ево како да укључите приступ Google Play Games Services Publishing API-ју помоћу Play конзоле.

1. Отворите Google Play конзолу.
2. Идите на ПодешавањеПриступ API-ју.
3. Ако већ нисте, направите повезани пројекат.
4. Кликните на дугме Укључи поред „API за конфигурацију игара“.

Управљајте са више корисника

Ако имате више корисника који управљају играма на налогу програмера, треба да управљате дозволама на страници Корисници и дозволе у Play конзоли.