落地页/首页

Kivicube 默认会在内容真正开始前展示一套首页/落地页 UI，例如：

• Logo
• 标题
• 背景图
• 立即体验按钮

如果你的业务希望保留这套默认体验，只需要保持默认属性即可。

可控的首页元素

当前 Web 插件能直接控制的首页相关属性主要有：

• hideLogo
• hideTitle
• hideDownload
• hideStart

示例：

await kivicubeIframePlugin.openKivicubeScene(iframe, {
  sceneId,
  hideLogo: true,
  hideTitle: true,
});

自定义宿主落地页

更常见的做法是：

1. 宿主页面自己渲染一层品牌化落地页
2. Kivicube iframe 先放在底层或占位区域
3. 等 ready 或 downloadAssetEnd 之后，再将 iframe 的“立即体验”按钮展示出来，或通过高级 API 去读取、调整按钮区域。

例如：

iframe.addEventListener('downloadAssetEnd', () => {
  hideHostLandingPage();
  showIframeLandingPage();
});

如果你只是想把宿主层按钮和 iframe 内真实按钮对齐，而不是强制隐藏它，优先参考 立即体验按钮 中的 getStartButtonRect() / setStartButtonRect()。

什么时候保留默认首页

适合：

• 快速接入
• 对品牌样式要求不高
• 需要依赖平台现成的首页配图与文案

什么时候自定义宿主首页

适合：

• 活动页、品牌页、营销页
• 希望把 Kivicube 体验和主站设计完全统一
• 需要和宿主自己的埋点、登录、任务流程联动

建议

如果你准备自定义首页，通常会同时搭配这些属性：

• hideLogo: true
• hideTitle: true
• 视需要决定是否 hideStart: true

但要注意，hideStart 会影响媒体自动播放成功率，只有在你非常清楚后果时再使用。

如果只是想改按钮位置或外面叠一层品牌按钮，不一定需要 hideStart。

详细说明见下一页。