渠道特性

各渠道允许游戏做的事不同,自己绘制的 UI 多少也不同。FRVR.channelCharacteristics 是一个描述当前渠道的标志对象。在 FRVR.init() 之后、构建依赖它的 UI 之前读取。

if (FRVR.channelCharacteristics.allowExternalLinks) {
  showPrivacyPolicyLink();
}

标志

标志	默认值	为 `true` 时
`allowExternalLinks`	`true`	游戏可以打开指向其他网站的链接。
`allowInternalLinks`	`true`	游戏可以打开宿主内部的链接。
`allowNavigation`	`true`	游戏可以修改 `location` 跳到其他路径。
`allowSendBeacon`	`true`	可以使用 `navigator.sendBeacon`。
`allowThirdPartyDomains`	`true`	允许请求第三方域名。
`hasDedicatedLoadingScreen`	`true`	渠道显示自己的加载界面。
`allowSharing`	`true`	游戏可以显示分享按钮。`false` 表示不支持分享,或由宿主自己的 UI 处理。
`hasNativeAudioControls`	`false`	宿主绘制声音和音乐开关,并控制游戏的音频。见音频状态。
`usesPlatformLifecycle`	`false`	暂停和恢复只来自平台的 SDK。见下文。

旧的渠道包里可能没有 allowSharing 和 hasNativeAudioControls。缺少 allowSharing 时按 true 处理,缺少 hasNativeAudioControls 时按 false 处理:

const chars = FRVR.channelCharacteristics;
if (chars.allowSharing !== false) showShareButton();
if (chars.hasNativeAudioControls) hideAudioToggles();

隐藏宿主已经显示的内容

在 frvr.com 的游戏页面上,游戏外层的页面负责绘制分享按钮、法律链接,以及声音和音乐开关。渠道上报 allowSharing: false、allowExternalLinks: false 和 hasNativeAudioControls: true,游戏最好隐藏自己的对应控件。

平台生命周期

usesPlatformLifecycle 为 true 时,SDK 不会挂 focus、blur 或 Page Visibility 监听。游戏收到的每一次暂停和恢复都来自平台。YouTube Playables 要求这样做。

对游戏来说没有变化:继续使用生命周期回调,不要自己加可见性监听。