Table of Contents

Управление целевыми изображениями

Целевые изображения (Targets) можно управлять двумя способами:

  • Визуальное управление: Войдите в центр разработки EasyAR для ручного обслуживания.
  • Автоматизированное управление через API: Интегрируйте в собственную бизнес-систему или административную панель, вызывая Web Service REST API.
Важно

В сервисе облачного распознавания управление целевыми изображениями и распознавание изображений — это разные задачи, для них предусмотрены разные конечные точки (Cloud URL) API.

Выбор региона дата-центра

Поддерживаемые регионы для дата-центра, где запускается экземпляр библиотеки изображений:

  • Китай — Шанхай
  • США — Силиконовая долина

Способ 1: Управление целевыми изображениями в центре разработки EasyAR

Подходит для небольших тестов или быстрой ручной загрузки. Шаги:

  1. Войдите в центр разработки EasyAR, перейдите в раздел Управление облачным распознаванием.
  2. Выберите целевой регион. Если библиотека изображений еще не создана, создайте и активируйте ее для облачного распознавания.
  3. В списке библиотек нажмите Управление, чтобы перейти в интерфейс обслуживания целевых изображений для загрузки, изменения или удаления.

create-web

Способ 2: Автоматизированное управление с помощью REST API

Для приложений, требующих обработки большого количества целевых изображений, рекомендуется использовать Web Service REST API для автоматизации процессов в вашем приложении или административной панели.

Подготовительный список

Вот что необходимо подготовить. Перед началом управления целевыми изображениями вам потребуется новый экземпляр базы данных облачного распознавания (Cloud Database):

  • CRS AppId
  • ключ API / Секрет API или Токен
  • Cloud URL
    • Server-end URL: Адрес URL для управления целевыми изображениями, использует порт 443 для https
    • Client-end URL: Адрес URL сервиса распознавания изображений, использует порт 8443 для https
Важно

Разъяснение различий портов: Конечная точка API для управления целями (443) и конечная точка API облачного распознавания, вызываемая из мобильных приложений/Unity (8443) — это два разных канала. Обязательно различайте их при настройке.

Как получить элементы списка

  • Просмотр CRS AppId:
    Центр разработки -> Управление облачным распознаванием -> Выберите библиотеку изображений -> Управление -> Ключи

m1-appid

  • Просмотр ключа API / Секрета API:
    Центр разработки -> APIKey облачных сервисов -> Копировать

m1-apikey

    Если у вас еще нет ключа API, создайте его, обязательно выбрав разрешение для облачного распознавания (CRS). Подробнее о ключе API и управлении доступом см. в разделе Введение в API Key

m1-apikey-cr

  • Просмотр токена:
    Центр разработки -> APIKey облачных сервисов -> Управление -> Выберите срок действия -> Сгенерировать токен -> Копировать

m1-token

    Если вам нужен пользовательский срок действия токена, вы можете использовать исходные APIKey и APISecret для создания токена, как описано в разделе UAC API —— Создание токена

  • Просмотр Cloud URL:
    Для управления целевыми изображениями в библиотеке используется Server-end URL (порт 443), Server-end URL
    Центр разработки -> Управление облачным распознаванием -> Выберите библиотеку изображений -> Управление -> Ключи -> Управление библиотекой

m1-server-url

Руководство по интеграции на нескольких платформах

В реальном рабочем процессе управление целевыми изображениями обычно интегрируется в бизнес-сервер разработчика, мобильное приложение или Unity:

  • Бизнес-платформа: Предоставляет примеры кода вызова API на распространенных серверных языках (Curl/Java/NodeJS/PHP), помогая разработчикам реализовать автоматическую загрузку целевых изображений и обновление метаданных (Meta).

  • Мобильная платформа (Unity/Mobile): Предоставляет пример кода управления целевыми изображениями на основе Unity, позволяя разработчикам реализовать собственный способ загрузки изображений (например, через фотографирование).

Запуск примеров кода

На рисунке показано использование примера кода на Java: заполните элементы подготовительного списка в примере кода и запустите Main

m1-java

Связанные темы:

Следующая тема:

Примечание

В реальном рабочем процессе при создании целевых изображений рекомендуется следовать лучшим практикам. Внимательно ознакомьтесь с ними.