Оценка QPS и масштабирование
Параллельность измеряется QPS (Queries per second), то есть количеством действительных сервисных запросов, полученных сервером за секунду. Независимо от того, успешна ли локализация, если запрос содержит правильный AppId облачной библиотеки карт локализации и проходит аутентификацию, он учитывается в статистике параллельности.
После успешной инициализации устройство по умолчанию отправляет запросы локализации с частотой 1 раз в секунду. Из-за сетевой задержки и различий во времени поступления запросов мгновенная параллельность может превысить лимит QPS. Например, 10 QPS теоретически поддерживают 10 устройств, но если в одну секунду получено более 10 запросов, лишние запросы будут отклонены. Чтобы обеспечить стабильность сервиса в сценариях параллельной работы нескольких устройств, рекомендуется резервировать некоторый запас при покупке QPS. Например, для поддержки 10 устройств можно настроить 11-12 QPS.
Группы облачного сервиса локализации по умолчанию предоставляют 10 параллельных запросов, что подходит для большинства сценариев приложений. Для сценариев с более высокой параллельностью мы также предоставляем гибкие варианты расширения ресурсов:
- В периоды высокой параллельности, например в праздники, можно выбрать краткосрочный пакет расширения, чтобы временно увеличить параллельную способность
- Для приложений с большим числом пользователей и необходимостью стабильной поддержки высокой параллельности дополнительные ресурсы параллельности можно долгосрочно привязать к группе облачного сервиса в пределах срока ее действия
На базе 10 QPS можно гибко выбрать краткосрочный дополнительный пакет или долгосрочно увеличить фиксированную квоту параллельности, чтобы соответствовать потребностям ресурсов на разных этапах бизнеса.
Поведение при превышении лимита параллельности
Когда запросы мгновенно превышают выделенный QPS, сервис возвращает следующее сообщение об ошибке (пример):
statuCode: 21, message: "Exceed your QPS limitation"
Если пользователи в пробном статусе не могут выполнить локализацию, вероятная причина — недостаточный QPS. Рекомендуется открыть логи через Mega Toolbox и проверить ответные сообщения, как показано ниже:

Примечание
У пробных пользователей квота параллельности сравнительно мала. Когда локализация не выполняется, обращайте внимание на наличие ошибок превышения лимита.
Расширение параллельного QPS
Расширить квоту параллельности можно двумя способами:
- Офлайн-консультация с коммерческим отделом или поддержкой клиентов (подходит для масштабных, долгосрочных или индивидуальных требований)
- Прямое онлайн-обновление в консоли управления (подходит для временного или небольшого расширения)
Офлайн-консультация по коммерческому обновлению
Когда ожидаемая ежедневная параллельность превышает 50 QPS, рекомендуется связаться с отделом продаж EasyAR или поддержкой клиентов для организации расширения емкости и гарантии ресурсов. После расширения войдите в backend разработчика и подтвердите, что квота вступила в силу.
Процесс подтверждения квоты параллельности показан в рамке ниже:
Шаги операции:
- Developer Center -> Block Cloud Localization -> группа облачного сервиса локализации -> Current QPS

Рекомендуется подтвердить количество QPS после обновления и срок действия. Это можно посмотреть в интерфейсе управления EasyAR. В следующем разделе описана операция: Управление параллельным QPS
Онлайн-обновление
В консоли есть два входа для онлайн-обновления QPS, как показано ниже:
Developer Center -> Block Cloud Localization -> группа облачного сервиса локализации -> Upgrade
Developer Center -> Block Cloud Localization -> группа облачного сервиса локализации -> QPS details -> Upgrade

Важно
Для больших требований к параллельности выше 50 QPS все равно требуется коммерческая консультация, чтобы обеспечить стабильное предоставление ресурсов.
Управление параллельным QPS
Управление параллельностью в основном включает:
- Просмотр текущего количества QPS
- Расширение QPS
- Обновление срока действия части QPS
Интерфейс управления
Шаги операции
- Войдите в Developer Center -> Block Cloud Localization -> группа облачного сервиса локализации -> QPS details
Обновление количества QPS и срока действия

После перехода в QPS details интерфейс выглядит как на изображении выше. Текущее количество QPS отображается в рамке справа.
Временная шкала в середине интерфейса показывает сроки действия базовой части QPS и обновленной части QPS.
Записи покупок внизу показывают заказы обновления и подробности срока действия.
Рекомендации
- Оценивайте ожидаемую пиковую параллельность, а не среднюю, и резервируйте запас для пика (например, для пика 10 QPS рекомендуется купить 11-12 QPS).
- Во время праздников или мероприятий можно временно приобрести краткосрочный дополнительный пакет для высоких требований к параллельности.
- Проверка после расширения: используйте Mega Toolbox в сценариях высокой параллельности, чтобы убедиться, что запросы не отклоняются, а ответы стабильны.
- При постоянных отказах или ошибках соберите логи и обратитесь в службу поддержки для диагностики, указав временное окно, AppId облачной библиотеки карт локализации, желательно также предоставить файл захвата пакетов с примерами запросов и кодами ошибок.