Table of Contents

CRS よくある質問

以下は、cloud image recognition 機能の使用中によくある質問と回答です。

Q: CRS はクラウドから 3D モデル/仮想コンテンツをロードできますか?

A: はい。CRS は次の方法で 3D モデル/仮想コンテンツのロードをサポートします。

  • meta プロパティ: target image の meta フィールドに AR コンテンツをテキストファイル形式で保存します。3D モデルは Base64 でテキストにエンコードするか、Alibaba Cloud OSS や AWS S3 などの cloud storage URL として保存できます。
  • ロードフロー: クライアントが CRS から meta データを取得した後、Unity や Three.js などの 3D engine を使用してモデルを解析しロードします。
  • 参考ドキュメント: 認識 target を作成 | POST /targets を参照してください。
注記

大きなファイル（>2MB）は URL 方式を使用し、Base64 エンコードによって request body が大きくなりすぎることを避けてください。

Q: CRS に認識回数制限はありますか?

A: 総認識回数の制限はありませんが、concurrency の段階があります。

  • 基本モード: QPS < 50 のアプリケーションに適しています。ハードリミットはありませんが、fair use の原則に従う必要があります。
  • 高 concurrency モード: QPS >= 50 の場合、認識の安定性と低遅延を確保するため、専有リソースの cloud service へのアップグレードを推奨します。
重要

祝日や大型イベント期間中にアプリケーションで一時的な concurrency の急増が予想される場合は、少なくとも 3 営業日前までに EasyAR テクニカルサポートへ連絡し、サービスアップグレードを申請してください。

Q: Web Service API が 404 を返す原因は何ですか?

A: 404 エラーは通常、リクエストされた URL パスが存在しない、またはリソースが見つからないことを意味します。よくある原因は次のとおりです。

  • URL 形式エラー: 存在しない endpoint にアクセスしています。例えば、http://your_crs_uuid.na1.crs.easyar.com:8888 へ直接アクセスするのは無効です。http://your_crs_uuid.na1.crs.easyar.com:8888/ping のような完全な endpoint を使用してください。
  • 認識結果が空: /search インターフェイスを呼び出したとき、どの target にも一致しない場合も 404 が返され、message body は No result: there is no matching になります。

トラブルシューティング手順:

  1. UUID とポートを含め、URL のスペルが正しいことを確認します。
  2. /ping インターフェイスを使用してサービス可用性をテストします。
  3. 画像データや API Key など、リクエストパラメータが完全かどうかを確認します。

解決提案: /search が 404 を返す場合、現在の画像が target にヒットしていないことを意味します。ユーザーに撮影角度を調整するよう案内するか、target が CRS にアップロード済みか確認してください。

Q: よくある Web Service API エラーレスポンスコードの原因は何ですか?

A: 404 以外では、次のエラーコードがよく見られます。

  • 400 invalid appId (appKey)

    • 原因: リクエストした Key が正しくない、または署名検証に失敗しました。
    • 確認: Key が CRS image library からコピーされたものか、POST リクエストに完全な署名が含まれているか、リクエストパラメータが Content-Type: application/json を使用しているかを確認します。

  • 400 invalid date

    • 原因: リクエスト timestamp が無効、またはサーバー時刻との差が大きすぎます。通常は +/-5 分以内が要求されます。
    • 確認: デバイス時刻が正確か確認します。特にタイムゾーン設定に注意してください。

  • 415 unsupported media type

    • 原因: HTTP Header に Content-Type: application/json が設定されていない、または request body の形式が誤っています。
    • 確認: POST リクエストの Header に Content-Type: application/json が含まれ、Body が有効な JSON であることを確認します。

一般的な提案: すべての CRS API リクエストは CRS API ドキュメント に厳密に従う必要があります。

説明: 上記の FAQ は CRS 使用中の高頻度な問題をカバーしています。新しい問題を報告する必要がある場合は、フィードバックをお送りいただき、お問い合わせ ください。