Встройте узел Pulsar в своё приложение

01Рамки ресурсов

SDK держит щадящий адаптивный потолок, который нельзя превысить, — именно это удерживает приложения в правилах App Store и Google Play и не даёт устройствам греться.

02Зарегистрируйте устройство (аккаунт не нужен)

Приложение авторизуется своим ключом и привязывает провизорное устройство. Заработанные им очки лежат в эскроу, пока пользователь их не заберёт.

POST https://astrina.io/api/v1/node/app-enroll
X-App-Key: pa_…            (your app key)
{ "kind":"mobile", "consent":1, "caps":{"uptime":1,"perf":1} }
→ { "device_id":123, "secret":"pn_…", "claim_code":"CLM-…" }

03Привяжите аккаунт позже — вход через Astrina

Когда пользователь захочет сохранить очки, проведите его через Вход через Astrina — тот же брокер личности, что используют другие интеграции Astrina, — и погасите claim-код. Очки из эскроу перейдут на реальный аккаунт.

POST https://astrina.io/api/v1/node/claim
(the user is signed in with Login with Astrina)
{ "claim_code":"CLM-…" }
→ { "ok":true, "device_id":123, "ap":12.5 }

04SDK

Одно встраиваемое ядро крутит цикл; приложение делает три вызова. Оно же рисует экран согласия и хранит секрет устройства и claim-код за вас.

final pulsar = PulsarApp(appKey: 'pa_…');
await pulsar.enroll();                 // once, after the consent screen
Timer.periodic(Duration(seconds: 60), (_) => pulsar.tick());   // while in foreground
await pulsar.linkAccount();            // opens Login with Astrina, then claims

05Получите ключ приложения

Ключи приложений выдаются после короткой проверки. Расскажите о приложении — вышлем client id и ключ. Пишите на [email protected].