背景及影响

Google Chrome 出于安全性考虑，计划在即将于 2025 年 7 月 30 发布的 139 版本中引入重大变更。经技术验证，届时所有使用火山引擎云游戏旧版本 Web SDK 的业务将无法正常观看云手机画面。

应对方案

为应对 Chrome 浏览器升级带来的兼容性问题，火山引擎云游戏于 2025 年 5 月 26 日发布了新版 Web SDK，版本号为 1.65.0。本次版本升级旨在有效规避因浏览器更新所导致的兼容性风险，确保用户获得持续、稳定、流畅的服务体验。
为了不影响您的业务正常运转，我们强烈建议您在 2025 年 7 月 30 日之前，将正在使用的火山引擎云游戏 Web SDK 升级至最新版本。

具体操作

1. 确认当前版本：检查工程中 package.json 文件（npm 项目）或查看 SDK 初始化日志中的版本标识。

2. 升级至新版本：

   • 若手动引入离线 SDK 包，在获取 SDK 和 Demo页面下载最新版本 SDK 包文件，并替换您项目中的旧版 SDK 文件即可。

   • 若使用包管理工具（以 npm 为例）引入 SDK，参照以下命令升级至最新版本，需确保版本号 >= 1.65.0。

     • 编辑 package.json 中 @volcengine/vephone 版本号相关的部分：

     {
       "dependencies": {
         "@volcengine/vegame": "^1.65.0"
       }
     }
     

     • 重新使用包管理器安装依赖。

3. 变更验证：在客户端 SDK 发布历史中核对您升级前所用版本与最新版本的功能差异，在工程项目中完成修改并测试验证后即可上线。

联系我们

若在升级过程中遇到任何问题或需要进一步的技术支持，您可以提交工单联系我们。感谢您对火山引擎云游戏团队的理解与配合。