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。
排查步骤：
- 确认 URL 拼写无误，包括 UUID 和端口。
- 使用
/ping接口测试服务可用性。 - 检查请求参数是否完整（如图像数据、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。
- 原因：HTTP Header 未设置
通用建议：所有 CRS API 请求需严格遵循 CRS API 文档。
说明：以上 FAQ 覆盖了 CRS 使用中的高频问题，如需报告新的问题，欢迎反馈并联系我们！