小程序内嵌 SaaS 观看页使用邀请海报对接指南

1. 适用场景

本文适用于接入方将微信小程序通过 <web-view> 方式内嵌保利威 SaaS 观看页，并希望在观看页内使用邀请海报完成分享和溯源的场景。

典型诉求包括：

• 观看页观众在接入方小程序内观看保利威 SaaS 直播观看页。
• 分享发起观众点击分享后，可以生成带小程序码的邀请海报。
• 扫码访问者扫描海报中的小程序码后，进入接入方小程序页面。
• 接入方希望通过小程序码参数识别分享来源，例如频道、邀请海报、分享人等。

需要注意的是，小程序码必须由接入方的小程序服务端生成。保利威无法使用接入方小程序的 appid 和 secret 代为生成小程序码。

2. 解决方案一：SaaS 输出邀请海报，接入方提供小程序码接口

2.1 实现方式

这种方式下，邀请海报页面由保利威 SaaS 观看页输出，接入方只需要提供一个获取小程序码的接口。

实现逻辑：

• 接入方在保利威后台配置“获取小程序码接口”。
• 分享发起观众在 SaaS 观看页点击分享或生成邀请海报。
• 保利威调用接入方配置的接口。
• 接入方服务端根据参数生成带参小程序码。
• 接入方接口返回小程序码图片地址。
• 保利威将该小程序码渲染到 SaaS 邀请海报中。

保利威负责：

• 输出 SaaS 原生邀请海报页面。
• 调用接入方配置的小程序码接口。
• 将接入方返回的小程序码图片展示到邀请海报中。

接入方负责：

• 准备微信小程序生成码能力。
• 提供获取小程序码接口。
• 根据保利威传入的参数生成对应的小程序码。
• 确保扫码访问者扫码后能进入接入方小程序指定页面。

优势：

• 接入方无需单独开发邀请海报 UI。
• 邀请海报体验与 SaaS 观看页保持一致。
• 接入方开发范围集中在小程序码接口。

注意事项：

• 小程序码生成逻辑仍由接入方服务端负责。
• 接入方需要保证接口稳定可用。
• 小程序码参数需要和接入方小程序落地页解析逻辑保持一致。

2.2 对接流程

graph TD
    A["分享发起观众点击分享"] --> B["SaaS 观看页生成邀请海报"]
    B --> C["保利威调用接入方小程序码接口"]
    C --> D["接入方服务端生成小程序码"]
    D --> E["返回小程序码图片地址"]
    E --> F["SaaS 邀请海报展示小程序码"]
    F --> G["扫码访问者扫码进入接入方小程序"]

1. 接入方确认小程序扫码后的落地页。
2. 接入方服务端接入微信小程序码生成能力。
3. 接入方开发“获取小程序码接口”，接口返回小程序码图片地址。
4. 接入方在保利威后台配置该接口地址。
5. 分享发起观众在 SaaS 观看页点击分享并生成邀请海报。
6. 保利威调用接入方接口获取小程序码。
7. 接入方接口根据参数生成小程序码并返回图片地址。
8. 保利威将小程序码展示到邀请海报中。
9. 扫码访问者扫码进入接入方小程序。

接入方需要完成：

• 准备小程序 appid 和 secret。
• 准备服务端生成小程序码的能力。
• 提供可被保利威调用的小程序码接口。
• 明确小程序码中需要携带的溯源参数。
• 在小程序落地页解析参数并完成后续业务处理。

3. 解决方案二：接入方在小程序原生层自行开发分享页

3.1 实现方式

这种方式下，接入方在小程序 WebView 外层自行实现分享按钮、分享弹窗、邀请海报和小程序码展示。

实现逻辑：

• SaaS 观看页作为 H5 页面运行在小程序 <web-view> 内。
• 接入方在 WebView 外层叠加小程序原生组件。
• 分享发起观众点击接入方开发的分享入口。
• 接入方小程序调用接入方服务端生成小程序码。
• 接入方小程序自行展示邀请海报或分享弹窗。

保利威负责：

• 提供 SaaS 观看页内容。
• 不参与接入方原生分享页的 UI 和小程序码生成链路。

接入方负责：

• 设计并开发小程序原生分享入口。
• 设计并开发邀请海报 UI。
• 调用接入方服务端生成小程序码。
• 展示海报、保存海报或触发小程序分享能力。
• 维护分享链路中的业务逻辑和溯源逻辑。

优势：

• 分享页 UI 和交互完全由接入方控制。
• 可结合接入方自有业务能力，例如会员、优惠券、活动、分销等。
• 与 SaaS 邀请海报展示逻辑解耦。

注意事项：

• 接入方需要自行维护完整分享体系。
• 开发和测试成本较高。
• 分享体验是否与 SaaS 观看页一致，由接入方自行控制。

3.2 对接流程

graph TD
    A["分享发起观众点击接入方原生分享入口"] --> B["接入方小程序请求服务端生成小程序码"]
    B --> C["接入方服务端返回小程序码"]
    C --> D["接入方小程序展示自定义邀请海报"]
    D --> E["扫码访问者扫码进入接入方小程序"]

1. 接入方在小程序中通过 <web-view> 打开 SaaS 观看页。
2. 接入方在 WebView 外层开发原生分享入口。
3. 分享发起观众点击接入方原生分享入口。
4. 接入方小程序调用接入方服务端生成小程序码。
5. 接入方小程序展示自定义邀请海报或分享弹窗。
6. 扫码访问者扫码进入接入方小程序。
7. 接入方小程序解析参数并完成溯源。

接入方需要完成：

• 设计小程序原生分享入口和分享页。
• 开发邀请海报生成或展示能力。
• 准备服务端小程序码生成能力。
• 设计扫码落地页和参数解析逻辑。
• 维护分享、保存、扫码回流和溯源链路。

4. 方案对比