You need to enable JavaScript to run this app.
导航
常见问题
最近更新时间:2023.08.08 15:26:12首次发布时间:2023.02.21 12:03:40

通用问题

Q:云游戏控制台上「业务」的用途是什么?

A: 客户可以在云游戏控制台内创建多个业务,用于对不同的云游戏项目或场景进行分类管理,购买相应的实例资源(跨业务之间不共享资源,但资源不独立结算)、部署和上架不同类别的游戏,提高云游戏业务的管理效率。

Q:云游戏支持的视频清晰度如何?

A: 火山引擎云游戏支持的视频流分辨率、码率、帧率可参考 云游戏清晰度档位切换 接口说明文档。在启动游戏时,可通过客户端 SDK videoStreamProfileId 参数设置游戏启动时的游戏视频流清晰度;为支持不同的用户需求和场景,可通过调用客户端 SDK switchVideoStreamProfile 接口,切换游戏视频流清晰度。

Q:在火山引擎官网创建子账号后,如何开通子账号的访问权限?

A: 通过火山引擎主账号创建子账号时,需要为子账号赋予管理云游戏业务的 VeGameFullAccess 权限,否则使用子账号接入云游戏服务会鉴权失败。详细的操作步骤,可参考 最佳实践 中的说明。

入门体验

Q:云游戏客户端 SDK 对系统和环境的要求是什么?

A: Android SDK 支持 Android 4.3(Android-19+)及以上系统的真机设备,支持 armeabi-v7a。iOS SDK 支持 iOS 9.0 及以上系统版本的设备,仅支持真机(arm64)运行,不支持模拟器。如果因系统或环境问题导致接入云游戏服务失败,可联系火山引擎云游戏技术支持。

Q:如何获取临时鉴权密钥?

A: 用户鉴权密钥(Access Key、Secret Key、Token)是接入火山引擎云游戏服务时必需的参数。在接入体验阶段,可通过「云游戏控制台 > 接入引导 > 接入 SDK」页面生成一组临时鉴权密钥用于测试。参考以下示例:

alt

Q:如何查看业务 ID?

A: 业务 ID 是创建业务后自定生成的业务唯一标识,在调用云游戏服务端 OpenAPI 时是常用的参数。可通过 云游戏控制台 > 业务管理 > 业务详情 页面获取。 参考以下示例:

Q:如何获取快速接入云游戏服务的体验 Demo?

A: 我们提供支持 Android、iOS、Web/H5 端的快速接入云游戏服务的开源 Demo,可通过 GitHub 下载。可参考其中的 Readme 文档,修改必要的参数(火山引擎账号 ID、鉴权密钥等)后,即可快速接入云游戏服务、体验云游戏服务的主要功能。

Q:如何接入云游戏客户端 SDK 和服务端 OpenAPI?

A: 您可以通过云游戏「文档中心」或云游戏控制台获取客户端 SDK 下载地址。通过火山引擎「控制台 > 页面右上角用户信息 > API访问密钥」获取账号的鉴权密钥(AK/SK),然后参考 SDK 接入文档服务端 OpenAPI 文档 说明进行接口使用和业务开展。

Q:如何监控云游戏服务状态?

A: 可通过「云游戏控制台 > 业务管理 > 业务详情」页面配置接收回调消息的地址以及用于鉴权的 Access Key ID 和 Secret Access Key。完成回调服务接入配置,即可接收云游戏回调服务发送的游戏安装包解析任务结果、游戏上架结果、当次游戏服务生命周期事件、以及游戏热更结果等,监控云游戏服务状态。详细的操作步骤和回调的消息内容数据格式,可参考 回调服务接入指南

正式接入

Q:云游戏 Android 客户端 SDK 提供哪些接入方式?

A: 云游戏 Android 客户端 SDK 支持全量包和动态加载接入方式。可通过 SDK 下载页面 下载 SDK 全量包。如通过动态加载方式接入时出现问题,可通过以下方式进行问题排查:

  1. 检查工程中是否配置了云游戏客户端 SDK 的 Maven 仓库地址;详细说明,参考 快速接入
  2. 在1的基础上,如果仍有问题,可尝试通过 Gradle Sync 处理。
  3. 在2的基础上,检查是否已设置自动导包(Auto Import)。

Q:接入云游戏客户端 SDK 时,如何进行问题排查?

A: 在接入云游戏客户端 SDK,建议开启 Debug 模式打印日志,首先通过日志信息排查问题:

  • Android SDK:通过 setDebug 接口设置调试模式,参考 设置 Debug 模式
  • iOS SDK:通过 currentDeviceId 接口获取 SDK 生成的设备 ID,用于后台查询 SDK 日志,进行调试和问题排查。参考 获取设备 ID
  • Web/H5 SDK: 通过 setDebug 接口设置调试模式,参考 设置调试模式

Q:接入云游戏客户端 SDK 时,如何处理 SDK 抛出的错误信息?

A: 在运行过程中出现问题或错误时,云游戏客户端 SDK 会抛出相应的警告码或错误码,客户端开发人员可参考 SDK 接入文档中的警告码和错误码说明,在客户端展示相应的告警或错误信息,提示游戏用户进行相应的操作。云游戏客户端 SDK 警告码和错误码的分类如下:

  • 100xx:启动游戏相关的警告码或错误码
  • 200xx:音视频流相关的警告码或错误码
  • 300xx:SDK 接口调用相关的警告码或错误码
  • 400xx:云端游戏和实例资源相关的警告码或错误码
  • 500xx:客户端与云端游戏收发消息(Message Channel SDK)相关的警告码或错误码
  • 600xx:网络请求相关的警告码或错误码
  • 710xx:客户端与云端游戏进行文件传输相关的警告码或错误码

Q:在接入云游戏服务后,如何查询当前游戏和业务的资源占用量?

A: 可通过云游戏服务端 OpenAPI 接口查询游戏和业务的资源用量,用于计算可使用的并发服务容量:

  • 查询游戏维度和用户维度的资源容量信息,参考 服务容量详情 接口说明。
  • 查询当前业务已订购实例总量和已使用实例总量,参考 业务容量详情 接口说明。

Q:使用 Windows Firefox 浏览器打开云游戏 Web 客户端时,为什么延时数据显示为 0ms?

A: 使用 Windows Firfox 浏览器打开云游戏 Web 客户端时,onRemoteStreamStats 事件的 videoStats 中没有延时数据(rtt),延时数据显示为0,可能由于浏览器的兼容性导致。可以尝试更换浏览器解决该问题。