Інтеграція деяких можливостей соціальної ігрової мережі scoreloop в додаток на android, сервіс

Інтеграція деяких можливостей соціальної ігрової мережі scoreloop в додаток на android, сервіс
Таблиці рекордів з'явилися в іграх багато-багато років тому. Спочатку вони були дуже простими, згадаємо, наприклад, ігри для приставок з трехсімвольнимі іменами гравців.

Згодом таблиці рекордів ускладнювалися, результати стало можливо публікувати в інтернеті щоб побачити себе в глобальному списку.

Основні можливості

Таблиця результатів

Крок 2. Додаємо наш додаток, отримуємо для нього game id і секретний код.

Дальше можно пойти двумя путями — использовать CoreSocial SDK и делать все руками или воспользоваться ScoreloopUI и получить готовый UI для таблицы результатов и т.д. Ми підемо іншим шляхом.

Крок 3. Разархівіруем SDK в який-небудь каталог.

Я припускаю, що ви використовуєте Eclipse для розробки вашої програми. Відкриваємо проект ScoreloopUI зі складу SDK за допомогою команди File -> Import -> Existing Projects Into Workspace.

Також необхідно підключити бібліотеку scoreloop-core.jar до вашого проекту (Project -> Properties -> Libraries -> Add external JAR)

Крок 4. Виставте для вашого застосування необхідні дозволи.





Очевидно, що з додатком буде необхідний доступ до інтернету (INTERNET). Для чого потрібно READ_PHONE_STATE я точно не знаю, а READ_CONTACTS можна не вказувати, якщо виставите ui.feature.address_book = false у файлі scoreloop.properties.

Крок 5. Вкажіть ScoreloopUI активують, які буде використовувати вашу програму.






















Крок 6. Отримання файлу scoreloop.properties

Поверніться в веб-панель scoreloop.com, налаштуйте властивості гри (вкладка Game Properties), після цього клікніть на посилання "Get scoreloop.properties" на тій же сторінці і збережіть файл scoreloop.properties в папку / assets вашого проекту.

Крок 7. Ініціалізація і знищення фреймворка Scoreloop

Для ініціалізації і знищення класів фреймворка використовується клас ScoreloopManagerSingleton. Зверніть увагу, що операції, описані нижче, потрібно виробляти в класі програми, а не активують. Коли створите клас додатки (якщо у вас його ще немає), не забудьте вказати ім'я класу додатка в тезі «application» вашого маніфесту.

ScoreloopManagerSingleton. init (this. "секретний код, отриманий через веб-інтерфейс");

Крок 8. Відправлення результату гри на сервер

Ваша активують повинна реалізувати інтерфейс OnScoreSubmitObserver. Он состоит из метода onScoreSubmit, который будет вызван после отправки очков на сервер (очевидно, что эта операция занимает время и блокировать UI поток на такое время нельзя).

Реєструємо активують як спостерігача за результатами відправки:

ScoreloopManagerSingleton. get (). setOnScoreSubmitObserver (this);
Відправляємо окуляри на сервер:

Double scoreResult = 1450.0;
ScoreloopManagerSingleton. get (). onGamePlayEnded (scoreResult, null);
У методі onGamePlayEnded другий параметр - це режим гри (наприклад, легкий, складний і т.д). Поскольку мы не сконфигурировали режимы через веб-интерфейс, передаем null.

Крок 9. Відображення таблиці результатів

З цим зовсім все просто:

startActivity (new Intent (this. LeaderboardsScreenActivity. class));
Ось як це виглядає:

Інтеграція деяких можливостей соціальної ігрової мережі scoreloop в додаток на android, сервіс


Scoreloop за використання свого сервісу вимагає, щоб іконка вашого застосування мала поверх основного зображення невеликої логотип Scoreloop, як, наприклад, тут:

Робиться це нібито для того, щоб користувачі могли відразу побачити, що це додаток інтегровано з Scoreloop і почали качати його зі страшною силою, але ми то знаємо ...

Післямова