ARCore 1.33 云锚点端点变化
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
自 2022 年 8 月 1.33.0 版起,ARCore Cloud Anchor API 端点已弃用。所有使用 ARCore SDK 1.33.0 及更高版本构建的应用现在均以新的 ARCore API 为目标平台,这是一个通用 API,适用于所有 ARCore 云服务。所有使用 ARCore SDK 1.32.0 及更低版本构建的应用都将继续以旧版 API 为目标平台。
这项更改不会影响现有数据。一旦应用更新为使用 ARCore SDK 1.33.0 或更高版本,并且应用使用的 Google Cloud 项目中启用了新的 ARCore API,功能应与使用上一个端点时的功能相同。为了支持旧版应用,您可以在进行转换时同时启用这两个 API。
如果您的应用使用 Cloud Anchors API,您必须在 2023 年 8 月 31 日之前将其更新为使用 ARCore SDK 1.33.0 或更高版本。在此日期之后,使用 ARCore SDK 1.32.0 或更低版本编译的应用将无法再托管和解析云锚点。
命名变化
|
上一个 |
新观看者 |
API 名称 |
ARCore Cloud Anchor API |
ARCore API |
域名 |
arcorecloudanchor.googleapis.com |
arcore.googleapis.com |
更新应用以使用新端点
如需更新您的应用,请执行以下操作:
- 访问 Google Cloud Platform 控制台。
- 确定您的应用使用的是哪个云项目。
- 确保已启用 ARCore API。
- 更新您的应用以使用最新的 ARCore SDK。ARCore SDK 1.33 及更高版本将使用新的 ARCore API。
- 在您的应用中使用 Cloud Anchor API 功能来测试这些更改。
- 验证更新后的应用的 Cloud Anchor API 使用情况是否显示在 Google Cloud 项目中的 ARCore API 下,而不是显示在 ARCore Cloud Anchor API 下。
更新应用设置
- 如果您的 iOS 应用使用已签名的 JWT 进行授权,对于使用 ARCore SDK 1.33.0 及更高版本构建的应用,请将
audience
声明更改为 https://arcore.googleapis.com/
。
- 如果您的 API 密钥受到限制,您必须允许 ARCore API。
- 如果您从后端向 ARCore Cloud Anchor Management API 发送请求,则必须启用 ARCore API 并将域名更改为
arcore.googleapis.com
。
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-07-26。
[null,null,["最后更新时间 (UTC):2025-07-26。"],[[["\u003cp\u003eThe ARCore Cloud Anchor API is being replaced by a new, general-purpose ARCore API starting with ARCore SDK 1.33.0.\u003c/p\u003e\n"],["\u003cp\u003eApps using ARCore SDK 1.32.0 or lower must be updated to ARCore SDK 1.33.0 or later by August 31, 2023, to continue using Cloud Anchors.\u003c/p\u003e\n"],["\u003cp\u003eExisting Cloud Anchor data will not be affected by this change.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers need to enable the new ARCore API in their Google Cloud project and update their apps to use the latest ARCore SDK.\u003c/p\u003e\n"],["\u003cp\u003eApp settings may need to be updated, including JWT audience claims, API key restrictions, and backend request configurations, to reflect the new API endpoint.\u003c/p\u003e\n"]]],[],null,["# ARCore 1.33 Cloud Anchor endpoint changes\n\nAs of the August 2022 1.33.0 release, the\n**[ARCore Cloud Anchor API](https://console.cloud.google.com/apis/library/arcorecloudanchor.googleapis.com)**\nendpoint is deprecated. All apps built with ARCore SDK 1.33.0 and higher now target the\nnew\n**[ARCore API](https://console.cloud.google.com/apis/library/arcore)**,\ngeneral-purpose API intended for use with all ARCore cloud services. All apps\nbuilt with ARCore SDK 1.32.0 and lower will continue to target the older API.\n\nThis change will not affect existing data. Once an app is updated to use ARCore\nSDK 1.33.0 or later, and the new **ARCore API** has been enabled in the Google\nCloud project used by your app, functionality should remain the same as it did\nwhen using the previous end point. To support older app versions, you may enable\nboth APIs while making the transition.\n\nIf your app uses the Cloud Anchors API, you must update it to use ARCore SDK\n1.33.0 or later **before August 31, 2023**. After this date, apps compiled with\nARCore SDK 1.32.0 or earlier will no longer be able to host and resolve Cloud\nAnchors.\n\nNaming changes\n--------------\n\n\u003cbr /\u003e\n\n| | Previous | New |\n| API name | ARCore Cloud Anchor API | ARCore API |\n| Domain name | `arcorecloudanchor.googleapis.com` | `arcore.googleapis.com` |\n|-------------|------------------------------------|-------------------------|\n\n\u003cbr /\u003e\n\nUpdate your app to use the new endpoint\n---------------------------------------\n\nTo update your app:\n\n1. Visit the [Google Cloud Platform console](https://console.cloud.google.com/).\n2. Determine which cloud project your app uses.\n3. Ensure that the **ARCore API** is enabled.\n4. Update your app to use the latest ARCore SDK. ARCore SDK 1.33 and later use the new ARCore API.\n5. Test these changes by using Cloud Anchor API functionality in your app.\n6. Verify that the Cloud Anchor API usage for the updated app appears under the **ARCore API** in the Google Cloud project, and *not* under the **ARCore\n Cloud Anchor API**.\n\nUpdate app settings\n-------------------\n\n- If your iOS app is using signed JWTs for authorization, change the `audience` claim to `https://arcore.googleapis.com/` for apps built with ARCore SDK 1.33.0 and higher.\n- If your API key is [restricted](https://cloud.google.com/api-keys/docs/add-restrictions-api-keys), you must allow the ARCore API.\n- If you send requests to the ARCore Cloud Anchor Management API from your backend, you must enable the ARCore API and change the domain name to `arcore.googleapis.com`."]]