CRS よくある質問

以下は、イメージクラウド認識機能の使用中におけるよくある質問と回答です。

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

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

meta属性：ターゲットイメージの meta フィールドに AR コンテンツをテキストファイル形式で保存します。3D モデルは Base64 エンコードしてテキスト化するか、クラウドストレージ URL（例：Alibaba Cloud OSS、AWS S3）として保存できます。
ロードフロー：クライアントが CRS から meta データを取得後、3Dエンジン（例：Unity、Three.js）を使用してモデルを解析・ロードします。
参考ドキュメント：詳細は認識ターゲットの作成 | POST /targets を参照してください。

大容量ファイル（>2MB）は Base64 エンコードによるリクエストボディの肥大化を避けるため、URL 方式を使用してください。

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 への直接アクセスは無効です。代わりに /ping を含む完全なエンドポイント（例：http://your_crs_uuid.na1.crs.easyar.com:8888/ping）を使用してください。
認識結果なし：/search インターフェースを呼び出した際、一致するターゲットが存在しない場合も 404 が返され、メッセージ本文は No result: there is no matching となります。

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

解決案：/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 ヘッダーに Content-Type: application/json が設定されていない、またはリクエスト本文のフォーマットが不正。
- 調査：POST リクエストのヘッダーに Content-Type: application/json が含まれ、本文が有効な JSON であることを確認。

一般的な推奨事項：すべての CRS API リクエストは CRS API ドキュメントを厳密に遵守する必要があります。

説明：本 FAQ は CRS 使用中の高頻度問題を網羅しています。新たな問題を報告する場合は、フィードバックをお寄せいただき、お問い合わせください！