CRS 常見問題

以下是圖像雲識別功能使用中的常見問題與解答。

Q：CRS 支持從雲端加載 3D 模型/虛擬內容嗎？

A：是的，CRS 支持通過以下方式加載 3D 模型/虛擬內容：

• meta屬性：在目標圖像的 meta 字段中存儲 AR 內容，格式爲文本文件。3D 模型可通過 Base64 編碼爲文本，或保存爲雲存儲 URL（如阿里雲OSS、AWS S3）。
• 加載流程：客戶端從 CRS 獲取 meta 數據後，使用3D引擎（如 Unity、Three.js）解析並加載模型。
• 參考文檔：詳見 創建識別目標 | POST /targets。

附註

大文件（>2MB）請使用 URL 方式，避免 Base64 編碼導致請求體過大。

Q：CRS 有識別次數限制嗎？

A：沒有總識別次數限制，但存在併發量分級：

• 基本模式：適合 QPS < 50 的應用，無硬性限制，但需遵守公平使用原則。
• 高併發模式：QPS ≥ 50 時，建議升級至專享資源雲服務，以保障識別穩定性與低延遲。

重要事項

若應用在節假日或大型活動期間可能面臨臨時併發量激增，請務必提前至少3個工作日聯繫 EasyAR 技術支持申請服務升級。

Q：Web Service API 返回 404 是什麼原因？

A：404 錯誤通常表示請求的 URL 路徑不存在或資源未找到，常見原因如下：

• URL 格式錯誤：訪問了不存在的端點。例如：直接訪問 http://your_crs_uuid.na1.crs.easyar.com:8888 是無效的，應使用完整端點如 http://your_crs_uuid.na1.crs.easyar.com:8888/ping。
• 識別結果爲空：調用 /search 接口時，若未匹配到任何目標，也會返回 404，消息體爲 No result: there is no matching。

排查步驟：

1. 確認 URL 拼寫無誤，包括 UUID 和端口。
2. 使用 /ping 接口測試服務可用性。
3. 檢查請求參數是否完整（如圖像數據、API Key）。

解決建議：若 /search 返回404，說明當前圖像未命中目標，可引導用戶調整拍攝角度或檢查目標是否已上傳至 CRS。

Q：常見的 Web Service API 錯誤返回碼有哪些原因？

A：除 404 外，以下錯誤碼較爲常見：

• 400 invalid appId (appKey)

  • 原因：請求的 Key 不正確，或簽名驗證失敗。
  • 排查：確認您的 Key 是否在 CRS 圖庫內複製獲得；POST 請求是否包含完整簽名；請求參數是否使用了 Content-Type: application/json。

• 400 invalid date

  • 原因：請求時間戳無效或與服務器時間偏差過大（通常要求±5分鐘內）。
  • 排查：檢查設備時間是否準確（尤其注意時區設置）。

• 415 unsupported media type

  • 原因：HTTP Header 未設置 Content-Type: application/json，或請求體格式錯誤。
  • 排查：確保 POST 請求的 Header 包含Content-Type: application/json，且 Body 爲合法 JSON。

通用建議：所有 CRS API 請求需嚴格遵循 CRS API 文檔。

---

說明：以上 FAQ 覆蓋了 CRS 使用中的高頻問題，如需報告新的問題，歡迎反饋並聯繫我們！