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 使用中的高頻問題，如需回報新問題，歡迎回饋並聯絡我們！