SDK

Unity

Загрузка конфигов Veresk в игре на Unity с кешем на устройстве.

Репозиторий: VereskUnitySdk. Нужен Unity 2022.3 или новее.

Установка

В Unity откройте Package Manager → Add package from git URL и введите:

https://github.com/SaleyIlya/VereskUnitySdk.git#1.0.0

Подключение

Страница Integration генерирует этот код для вашего проекта. SDK строит URL как BaseUrl/ProjectId/…, поэтому CDN URL проекта делится по последнему сегменту: всё до него — BaseUrl, последний сегмент — ProjectId.

using VereskSDK;
using VereskSDK.Models;

VereskAPI.Init(new VereskSetupData
{
    BaseUrl = "<CDN base URL>",
    ProjectId = "<project id>",
    Version = "default",
    Consumer = "game-client",
});

// Имя файла -> сырое содержимое каждого конфига потребителя.
// Бросает исключение, если CDN недоступен и в кеше ничего нет.
Dictionary<string, string> configs = await VereskAPI.LoadConfigs();

Чтение конфига

using Newtonsoft.Json; // поставляется с SDK

var settings = JsonConvert.DeserializeObject<Settings>(configs["settings.json"]);

Замечания

  • Конфиги кешируются на устройстве и отдаются из кеша, когда CDN недоступен.
  • SDK не расшифровывает файлы. Зашифрованные файлы приходят шифртекстом, поэтому не используйте шифрование для конфигов, которые должен читать клиент Unity.
  • Версия и потребитель указываются по имени.