Table of Contents

ターゲット画像管理

ターゲット画像(Targets)は以下の2つの方法で管理できます:

  • 可視化管理:EasyAR 開発センターにログインして手動で管理します。
  • API 自動化管理Web Service REST API を呼び出して、自社の業務システムや管理バックエンドに統合します。
重要

クラウド認識サービスでは、ターゲット画像管理と画像認識は異なる要件であり、API はそれぞれ異なる Cloud URL エントリポイントに対応します。

データセンターリージョンの選択

図庫が稼働するデータセンターは以下のリージョンから選択可能です:

  • 中国-上海
  • アメリカ-シリコンバレー

方法1:EasyAR 開発センターでターゲット画像を管理

小規模なテストや手動での迅速なアップロードに適しています。操作手順は次のとおりです:

  1. EasyAR 開発センターにログインし、クラウド認識管理 に進みます。
  2. ターゲットリージョンを選択します。まだ図庫を作成していない場合は、新規作成しクラウド認識図庫を有効化してください。
  3. 図庫リストで 管理 をクリックすると、ターゲット画像管理画面に移動し、アップロード、変更、削除が行えます。

create-web

方法2:REST API を使用した自動化管理

大量のターゲット画像を処理する必要があるアプリケーションでは、Web Service REST API の使用を推奨します。これにより、アプリケーションや管理バックエンドで自動化プロセスを実現できます。

準備リスト

以下は準備が必要な項目です。ターゲット画像の管理を開始する前に、新しいクラウド認識データベースインスタンス(Cloud Database)を準備する必要があります。

  • CRS AppId
  • API Key / API Secret または Token
  • Cloud URL
    • Server-end URL:ターゲット画像管理用 URL アドレス、https は 443 ポートを使用
    • Client-end URL:画像認識サービス用 URL アドレス、https は 8443 ポートを使用
重要

ポートの区別について:ターゲット管理 API エントリ(443)とモバイル端末/Unity が呼び出すクラウド認識 API エントリ(8443)は異なる通信経路です。設定時には必ず区別してください。

リスト項目の取得方法

  • CRS AppId の確認方法:
    開発センター -> クラウド認識管理 -> 図庫を選択 -> 管理 -> キー

m1-appid

  • API Key / API Secret の確認方法:
    開発センター -> クラウドサービス APIKey -> コピー

m1-apikey

    まだ API Key をお持ちでない場合は、APIKey を作成する際に必ず クラウド認識(CRS) 権限を選択してください。API Key と権限制御の詳細については、トピックAPI Key 概要を参照

m1-apikey-cr

  • Token の確認方法:
    開発センター -> クラウドサービス APIKey -> 管理 -> 有効期間を選択 -> トークンを生成 -> コピー

m1-token

    カスタムの有効期間を設定する必要がある場合は、UAC API —— トークンの作成 を参考に、元の APIKey と APISecret を使用してトークンを作成できます

  • Cloud URL の確認方法:
    図庫のターゲット画像管理には Server-end URL 443 ポートを使用します。Server-end URL は以下で確認:
    開発センター -> クラウド認識管理 -> 図庫を選択 -> 管理 -> キー -> 図庫管理

m1-server-url

マルチエンド統合ガイダンス

実際のワークフローでは、ターゲット画像管理は通常、開発者の業務サーバー、モバイル端末、または Unity に統合されます:

  • 業務サービスプラットフォーム:一般的なサーバー開発言語(Curl/Java/NodeJS/PHP)向けの API 呼び出しサンプルコードを提供し、ターゲット画像の自動アップロードとメタデータ(Meta)更新を実現するのに役立ちます。

  • モバイル端末(Unity/Mobile):Unity ベースのターゲット画像管理サンプルコードを提供します。開発者は自身で写真を撮影してターゲット画像をアップロードする方法を実装します。

サンプルコードの実行

下図は Java サンプルコードの使用例です。サンプルコードに自身の準備リストの各項目を入力し、Main を実行します。

m1-java

関連トピック:

次のトピック:

注記

実際のワークフローでは、ターゲット画像の作成はベストプラクティスに従うことをお勧めします。必ず注意してご覧ください。