Changes

Начиная с версии Starting from version 2.1.0 движок работает по engine works by API только с авторизованными приложениямиwith authorized applications only. Авторизация выполняется на этапе рукопожатия Authorization takes place during handshake (более подробное описание смотрите нижеmore detailed description you can find below). Для успешной авторизации у приложения должен быть ключ продуктаTo be successfully authorized an application must have a product key.

Вы можете получить персональный ключ продукта для Вашего приложения, либо использовать публичный ключYou can get your personal product key for your application or use a public key:

Если Вы используете публичный ключIf you use the public key, то Ваше приложение смогут использовать только пользователи, у которая активирована опция your app can be used only by users who have activated option "No ADs" (отключение рекламы Ace Streamdisabling ads). Если у пользователя не активирована указанная опцияIf this option is not activated, то при попытке начать просмотр какого-либо контента движок отправит ошибку the engine will send an error "No ADs option must be activated to use this product"when user tries to start playback of some content.

'''ВниманиеAttention!''' После того как ваше приложение будет готово и Вы решите провести открытыйWhen your application is ready and you decide to make an opened/публичный тестpublic test, зарегистрируйтесь как send us a request to receive a test key by registering as [[Developers|разработчик приложенийdeveloper]] и отправьте нам запрос на получение ключа продукта для Вашего приложения, with a description of the application and a link to download it. После проверки Вашего приложения, мы предоставим специальный ключ продукта, который позволит Вам в течение After verification of your product we will give you a special product key which will allow you to make opened/public tests within 30 дней провести открытые/публичные тесты для любых пользователейdays for any users, в том числе и для пользователей, у которых нет подключенной опции including users who don't have enabled NoADsoption.Test for All!

Если Ваше приложение поддерживает рекламные форматы системы If your app supports ad formats of Ace Streamsystem, Вы можете бесплатно получить персональный ключ продукта. Для этого Вам необходимо зарегистрироваться как you can get a personal product key for free by registering as [[Developers|разработчик приложенийdeveloper]]. Приложения с персональным ключом продукта могут использовать все пользователиApplication with a personal product key can be used by all users, независимо от наличия у них каких-либо премиум-опцийregardless of whether they have any premium options.

== Формат ключа продукта Authorization of application ==Ключ продукта представляет собой строку из четырех групп символов, разделенных знаком "-". Каждая группа может состоять из символов [0-9A-Za-z]. Первая группа символов называется "'''публичная часть ключа продукта'''" и передается в открытом виде в различных запросах.Below the schema of application authorization is described:

== Авторизация приложения == * приложение отсылает сообщениеapplication sends handshake "HELLOBG" message

* движок отсылает в ответengine sends the answer

* приложение формирует ответный ключ и отсылает его движкуapplication generates response key and send it to engine

Если авторизация прошла нормально, то движок продолжит работу с приложением, отослав событие <tt>If the authorization was successfull then engine will continue to work with application and send an "AUTH</tt> " event (уровень авторизации пользователяuser authorization level).

Если авторизация не прошла, движок отправит приложению событие If the authorization failed then engine sends event <tt>NOTREADY</tt>. Это же событие будет отправляться в ответ на любые команды от неавторизованного приложения, кроме команд <tt>HELLOBG</tt>, <tt>READY</tt> и <tt>SHUTDOWN</tt>This event is also sent as answer to any command from an unauthorized application.

: представляет собой буквенноrandom alpha-цифровую строку, сгенерированную случайным образомnumeric string

: формируется из is generated from ''request_key'' и ключа продукта по следующему алгоритму, представленного в виде псевдокодаand product key with the following algorithm (described in pseudocode): <tt><nowiki>signature = hex(sha1(request_key + product_key)); // сгенерировать подпись запросаgenerate the request signaturex = product_key.split("-")[0]; // вырезаем все символы до первого знака cut all chars until first "-" из ключа продуктаfrom the product keyresponse_key = x + "-" + signature; // отправляем движку вырезанную на предыдущем этапе строку и подпись, разделенные знаком send the string from the previous step and request signature &crarr; separated by hyphen ("-") char to the engine</nowiki></tt>

== Пример Example ==Для примера предположим, что приложение использует ключ продукта In this example we suppose that the application has a product key 123456-111111-222222-333333

Подпись для Request signature for the given ''response_key'' в данном примере формируется такin this example is generated in this way: