Table of Contents

目標圖像管理

目標圖像（Targets）可以通過以下兩種方式進行管理：

  • 可視化管理：登錄 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 -> 管理 -> 選擇有效期 -> 生成 Token -> 複製

m1-token

    若您需要自定義 Token 的有效期，可以參考 UAC API —— 創建 Token 方式，使用原始 APIKey 和 APISecret 來創建 Token

  • 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

相關主題：

下一主題：

附註

實際工作流中，創建目標圖像建議遵循最佳實現，建議認真閱讀。