ターゲット画像リストのクエリ

クラウド認識（CRS）データベースには通常、膨大な数のターゲット画像が保存されています。開発者がこれらのデータを迅速に特定・管理できるように、本章ではターゲット画像の表示、ページネーションクエリ、および詳細説明について詳しく説明します。

EasyAR Web を通じたターゲット画像コレクションの管理

可視化インターフェースでは、システムはデフォルトでページネーションリスト形式でターゲット画像を表示し、最終変更時間の降順（最新の変更が最前列）でソートされます。

ターゲット画像コレクション

操作パス：EasyAR Web [開発センター] にログイン -> [クラウド認識管理] -> 画像ライブラリを選択 -> [管理] をクリック。

この画面では、以下の操作が可能です：

リスト閲覧：ページネーションで表示されるターゲット画像コレクションを確認。
詳細エントリー：図中のボタン1 [管理] をクリックすると、該当ターゲット画像の詳細ページに遷移。
精密検索：入力ボックス2 では、以下の2種類の検索方法をサポート：
- 名前検索：システムがルール（例：アプリ内ID）に基づき画像を命名している場合、名前で迅速に特定可能。
- TargetId 検索：類似画像クエリAPIから特定の targetId を取得後、ここで詳細設定を検索可能。

ターゲット画像の詳細説明

詳細ページに遷移後、ターゲット画像の完全な属性を確認できます：

グレースケール画像
画像名：カスタム定義されたターゲット画像識別子。
TargetId：システム生成の一意ID。
ステータス：現在のターゲット画像が有効化または無効化されているかを表示。
品質スコア：認識・追跡性能に関する定量評価。詳細はターゲット画像認識難易度評価を参照。
カスタムMeta：当該ターゲット画像に関連付けられたメタデータ（例：モデルURLなど）

detail

API を使用したターゲット画像コレクションのクエリ

独自バックエンドへの統合が必要な開発者は、REST API を使用した管理を推奨します。

参考ドキュメント：ターゲット画像コレクションリスト API インターフェース

準備リスト

リクエスト発行前に、以下の情報が準備されていることを確認してください（詳細は API 呼び出し準備リスト参照）:

CRS AppId
API Key / API Secret または Token
Server-end URL: ターゲット画像管理 URL アドレス（https は 443 ポート使用）

プレースホルダーを実際のパラメータに置き換えて、curlスクリプトを実行してください

Your-Server-side-URL → 実際のAPIホスト
Your-Token → 実際のAPIキー認証トークン
Your-CRS-AppId → あなたのappId

curl -X GET "https://<Your Server-side-URL>/targets/infos?appId=<Your-CRS-AppId>" \
  -H "Content-Type: application/json" \
  -H "Authorization: <Your-Token>"

Java サンプルコードのダウンロード

Java Samples Download

Maven 方式によるプロジェクトのインポート

ステップ 1. 関連するコードファイル ListTargets.java を開く

ステップ 2. グローバル変数を変更し、準備リストの認証パラメータを置き換える

CRS AppId
API Key / API Secret
TARGET_MGMT_URL → Server-end URL

public class ListTargets {

    private static final String TARGET_MGMT_URL = "http://cn1.crs.easyar.com:8888";
    private static final String CRS_APPID       = "--here is your CRS AppId--";
    private static final String API_KEY         = "--here is your API Key--";
    private static final String API_SECRET      = "--here is your API Secret--";

    public String list(Auth auth) throws IOException {
        OkHttpClient client = new OkHttpClient.Builder().build();
        JSONObject params = new JSONObject();
        Auth.signParam(params, auth.getAppId(), auth.getApiKey(), auth.getApiSecret());
        okhttp3.Request request = new okhttp3.Request.Builder()
                .url(auth.getCloudURL() + "/targets/infos?"+ Common.toParam(params))
                .get()
                .build();
        Response response = client.newCall(request).execute();
        return response.body().string();
    }
    public static void main(String[] args) throws IOException{
        Auth accessInfo  =  new Auth(CRS_APPID, API_KEY, API_SECRET, TARGET_MGMT_URL);
        System.out.println(new ListTargets().list(accessInfo));
    }

}

ステップ 3. Main を実行

NodeJSサンプルコードのダウンロード

NodeJS Samples Download

ステップ1. 鍵ファイルkeys.jsonの設定

CRS AppId
API Key / API Secret

{
  "appId": "--here is your appId for CRS App Instance for SDK 4--",
  "apiKey": "--here is your api key which is create from website and which has crs permission--",
  "apiSecret": "--here is your api secret which is create from website--"
}

ステップ2. 実行、鍵ファイルおよびサーバーエンドURLの指定

node bin/getTargets  -t <Server-end-URL> -c keys.json

ページング戦略を変更する必要がある場合は、getTargetsにページングパラメータを渡します

'pageSize': ページサイズ
'pageNum': ページ番号

var argv = require('yargs')
    .usage('Usage: $0 [targetId] -t [host] -c [keys]')
    .demand(0)
    .default('t', 'http://localhost:8888').alias('t', 'host')
    .default('c', 'keys.json').alias('c', 'keys')
    .help('h').alias('h', 'help')
    .epilog('copyright 2015, sightp.com')
    .argv;

var fs = require('fs');
var host = argv.host;
var keys = JSON.parse(fs.readFileSync(argv.keys));
var farmer = require('../farmer')(host, keys.appKey, keys.appSecret);

farmer.getTargets({
  'pageSize': 5,
  'pageNum': 1,
})
.then(function(resp) {
    console.log(resp.result.targets);
})
.fail(function(err) {
    console.log(err);
});

getTargetsはクラウドサービスのインターフェースを呼び出し、サンプルコードはfarmer.jsにあります

function getTargetsByPage(pageNum,pageSize) {
    return Q.promise(function(resolve, reject) {
        request.get(host + '/targets/infos?pageNum=' + pageNum + '&pageSize=' + pageSize)
        .query(auth.signParams(keypair, {
            "pageNum":pageNum,
            "pageSize":pageSize
        }))
        .end(done(resolve, reject));
    });
}

Php サンプルコードのダウンロード

PHP Samples Download

ステップ 1. エントリコード demo.php を開く

ステップ 2. グローバル変数を修正し、準備リストの認証パラメータを置き換える

CRS AppId
API Key / API Secret
サーバーエンドURL

<?php
include 'EasyARClientSdkCRS.php';
$apiKey = 'API Key';
$apiSecret = 'API Secret';
$crsAppId = 'CRS AppId'
$crsCloudUrl = 'https://cn1-crs.easyar.com';
$pageNum = 1;
$pageSize = 5;

$sdk = new EasyARClientSdkCRS($apiKey, $apiSecret, $crsAppId, $crsCloudUrl);

$rs = $sdk->targetsV3($pageNum, $pageSize);
if ($rs->statusCode == 0) {
    print_r($rs->result);
} else {
    print_r($rs);
}

ステップ 3. php demo.php を実行する

新しいコードファイル list_targets.py を作成し、グローバル変数を変更してから実行します

pip install requests
python list_targets.py

import time
import hashlib
import requests

# --- Global Configuration ---
API_KEY = "YOUR_API_KEY"
API_SECRET = "YOUR_API_SECRET"
APP_ID = "YOUR_APP_ID"
HOST = "https://crs-cn1.easyar.com"

def main():
    timestamp = str(int(time.time() * 1000))
    
    params = {
        'apiKey': API_KEY,
        'appId': APP_ID,
        'timestamp': timestamp
    }

    # Signature: Sort keys -> Concat -> Append Secret -> SHA256
    sorted_keys = sorted(params.keys())
    sign_str = "".join([f"{k}{params[k]}" for k in sorted_keys]) + API_SECRET
    signature = hashlib.sha256(sign_str.encode('utf-8')).hexdigest()

    url = f"{HOST}/targets/infos"
    params['signature'] = signature

    print(f"Requesting GET {url}...")
    response = requests.get(url, params=params)
    print(f"Response: {response.text}")

if __name__ == "__main__":
    main()

関連コードファイル main.go を新規作成し、グローバル変数を修正して実行します

go run main.go

main.go:

package main

import (
  "crypto/sha256"
  "fmt"
  "io"
  "net/http"
  "sort"
  "strconv"
  "time"
)

// --- グローバル設定 ---
var (
  ApiKey    = "YOUR_API_KEY"
  ApiSecret = "YOUR_API_SECRET"
  AppId     = "YOUR_APP_ID"
  Host      = "https://crs-cn1.easyar.com"
)

func main() {
  ts := strconv.FormatInt(time.Now().UnixNano()/1e6, 10)
  params := map[string]string{
    "apiKey":    ApiKey,
    "appId":     AppId,
    "timestamp": ts,
  }

  keys := make([]string, 0, len(params))
  for k := range params { keys = append(keys, k) }
  sort.Strings(keys)

  builder := ""
  for _, k := range keys { builder += k + params[k] }
  builder += ApiSecret

  signature := fmt.Sprintf("%x", sha256.Sum256([]byte(builder)))

  url := fmt.Sprintf("%s/targets/infos?apiKey=%s&appId=%s&timestamp=%s&signature=%s", 
    Host, ApiKey, AppId, ts, signature)
  
  resp, _ := http.Get(url)
  defer resp.Body.Close()
  body, _ := io.ReadAll(resp.Body)
  fmt.Printf("Response: %s\n", string(body))
}

Cargo.toml に reqwest, tokio, sha2, hex の依存関係を追加します。

cargo run を実行します。

use sha2::{Sha256, Digest};
use std::collections::BTreeMap;
use std::time::{SystemTime, UNIX_EPOCH};

// --- グローバル設定 ---
const API_KEY: &str = "YOUR_API_KEY";
const API_SECRET: &str = "YOUR_API_SECRET";
const APP_ID: &str = "YOUR_APP_ID";
const HOST: &str = "https://crs-cn1.easyar.com";

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let ts = SystemTime::now().duration_since(UNIX_EPOCH)?.as_millis().to_string();

    let mut params = BTreeMap::new();
    params.insert("apiKey", API_KEY);
    params.insert("appId", APP_ID);
    params.insert("timestamp", &ts);

    let mut sign_str = String::new();
    for (k, v) in &params {
        sign_str.push_str(k);
        sign_str.push_str(v);
    }
    sign_str.push_str(API_SECRET);
    
    let mut hasher = Sha256::new();
    hasher.update(sign_str.as_bytes());
    let signature = hex::encode(hasher.finalize());

    let url = format!("{}/targets/infos?apiKey={}&appId={}&timestamp={}&signature={}", 
                      HOST, API_KEY, APP_ID, ts, signature);
    
    let res = reqwest::get(url).await?;
    println!("Response: {}", res.text().await?);
    Ok(())
}

.NET コンソールプロジェクトを作成します。

dotnet new console
dotnet run

using System;
using System.Collections.Generic;
using System.Linq;
using System.Security.Cryptography;
using System.Text;
using System.Net.Http;

class Program {
    // --- Global Configuration ---
    static string API_KEY = "YOUR_API_KEY";
    static string API_SECRET = "YOUR_API_SECRET";
    static string APP_ID = "YOUR_APP_ID";
    static string HOST = "https://crs-cn1.easyar.com";

    static async System.Threading.Tasks.Task Main() {
        string timestamp = DateTimeOffset.Now.ToUnixTimeMilliseconds().ToString();

        var dict = new SortedDictionary<string, string> {
            { "apiKey", API_KEY },
            { "appId", APP_ID },
            { "timestamp", timestamp }
        };

        StringBuilder sb = new StringBuilder();
        foreach (var kv in dict) sb.Append(kv.Key).Append(kv.Value);
        sb.Append(API_SECRET);
        
        string signature = Sha256(sb.ToString());

        using var client = new HttpClient();
        string query = string.Join("&", dict.Select(x => $"{x.Key}={x.Value}")) + $"&signature={signature}";
        string url = $"{HOST}/targets/infos?{query}";
        
        var response = await client.GetAsync(url);
        Console.WriteLine($"Result: {await response.Content.ReadAsStringAsync()}");
    }

    static string Sha256(string str) {
        byte[] bytes = SHA256.HashData(Encoding.UTF8.GetBytes(str));
        return BitConverter.ToString(bytes).Replace("-", "").ToLower();
    }
}

動作環境
- Unity 2020 LTS 以降
- Scripting Backend: Mono または IL2CPP のいずれでも可
- API Compatibility Level: .NET Standard 2.1（推奨）

Step 1: 画像ファイルの準備

Unityプロジェクト内にディレクトリを作成:

Assets/
└── Scripts/
     └── ListImageTarget.cs

Assetsディレクトリ名に従って
- 以下のサンプルコード ListImageTarget.cs をコピー

using System.Collections;
using UnityEngine;
using UnityEngine.Networking;

public class ListImageTarget : MonoBehaviour
{
    [Header("Config")]
    public string apiBaseUrl = "https://Your-Server-end-URL";
    public string authorizationToken = "YOUR API KEY AUTH TOKEN"; 
    public string crsAppId = "CRS-AppId"; 
    public int pageSize = 5; 
    public int pageNum  = 1; 
    
    private void Start()
    {
        StartCoroutine(ListTarget());
    }

    private IEnumerator ListTarget()
    {
     
        string url =
            $"{apiBaseUrl}/targets/infos?appId={crsAppId}&pageSize={pageSize}&pageNum={pageNum}";

        UnityWebRequest request = UnityWebRequest.Get(url);
        request.downloadHandler = new DownloadHandlerBuffer();

        request.SetRequestHeader("Content-Type", "application/json");
        request.SetRequestHeader("Authorization", authorizationToken);

        yield return request.SendWebRequest();

        if (request.result == UnityWebRequest.Result.Success)
        {
            Debug.Log("List target success:");
            Debug.Log(request.downloadHandler.text);
        }
        else
        {
            Debug.LogError("List target failed:");
            Debug.LogError(request.error);
            Debug.LogError(request.downloadHandler.text);
        }
    }
}

Unity Editor内で:
- 空のGameObjectを作成
- ListTargetと命名
- ListImageTargetスクリプトをこのオブジェクトにアタッチ

Step 3: パラメータの設定（Inspector）

Inspectorパネルで以下を修正:
- Api Url
- Authorization Token
- Crs App Id
- page size
- page num
これらの項目を変更するだけで実行可能。準備済みのパラメータを入力

Step 4: 実行

Playをクリック
Consoleで結果を確認:
- 成功: JSONが返る（targetIdを含む）
- 失敗: HTTP/エラーメッセージ

関連トピック：

次のトピック：