现有 App 想增加直播和点播功能，应该接 SDK 还是 API？
现有 App 增加直播和点播通常不是在 SDK 与 API 之间二选一。本文说明客户端 SDK、服务端 API 和 WebView 的职责，列出不同技术栈的支持边界、服务商选型标准与最小 POC 路径。
企业已经有自己的 App，现在想增加直播、直播回放和视频点播，最容易先问：“应该接 SDK，还是直接调用 API？”这个问题不能只按接口数量判断，因为直播播放、点播上传、账号权限和频道管理分别发生在客户端与服务端，承担的职责并不相同。
先说结论：现有 App 增加直播和点播，通常不是在 SDK 和 API 之间二选一，而是根据接入深度组合使用。客户端需要播放、推流、上传或深度定制交互时，通常采用相应 SDK；账号权限、直播频道、视频内容、回调和业务流程管理，则由企业后端通过服务端 API 对接。希望先快速上线时，可以评估现成观看页或 WebView；需要保留 App 原生体验并打通会员、课程、商品或订单时，再采用 SDK＋API 深度集成。
01 SDK 和 API 不是二选一：SDK 管端侧体验，API 管后台协同
SDK 和 API 的区别，不在于谁“更高级”，而在于它们运行的位置和解决的问题不同。
1.1 客户端 SDK 负责把视频能力真正放进 App
用户在 App 中观看直播或点播视频，需要完成拉流、解码、播放、画面渲染和播放控制；如果 App 还承担手机开播，则会涉及摄像头和麦克风采集、编码与推流。上传点播视频、离线播放、界面定制和部分互动能力，也通常通过相应客户端 SDK 落地。
因此，当企业关心的是“播放器能否融入现有页面”“能否保持原生交互”“弱网下观看体验怎样”“能否按品牌设计播放器”时，重点应检查 SDK 和示例工程，而不是只看服务端 API 数量。
1.2 服务端 API 负责把视频平台接入企业业务流程
企业自己的后端仍然负责会员、员工、课程、商品、订单等业务。服务端 API 用于把这些流程与视频能力连接起来，例如创建或管理直播频道、管理点播视频、生成经过业务校验的观看参数、接收状态回调，以及把需要的数据关联到企业自己的用户和内容记录。
API 密钥和签名逻辑不应直接放在 App 客户端中。通常由企业后端调用视频服务，再把经过权限判断的结果返回 App，避免把平台凭证暴露给终端用户。
1.3 多数正式项目会组合使用 SDK 与 API
| 企业任务 | 主要接入方式 | 典型职责 |
|---|---|---|
| 先验证直播、回放或基础互动 | 现成观看页或 WebView＋少量后端对接 | 快速形成可观看闭环，首期定制较少 |
| 保留 App 原生播放和页面体验 | 直播/点播客户端 SDK＋服务端 API | 客户端负责播放或推流，后端负责频道、视频与权限 |
| 打通会员、课程、商品、订单或数据系统 | SDK＋服务端 API＋业务定制 | 统一身份、内容和业务数据，形成长期可维护的集成 |
这也是为什么“SDK 还是 API”通常不是单选题。真正需要决定的是：首期做到什么深度、哪些能力由视频平台承担、哪些业务继续留在企业自己的系统中。
02 现有 App 有三条接入路径，区别在上线速度和定制深度
2.1 现成观看页或 WebView：适合先验证业务
如果团队暂时没有音视频研发经验，首期目标只是让用户在 App 内打开直播、观看回放并完成基础互动，可以先评估把成熟的 SaaS 观看页嵌入 WebView。这样能够减少首期播放器和直播间页面的开发工作，但仍需要处理登录态、页面跳转、权限参数、系统兼容和必要的原生能力调用，不能把它理解成“零开发”。
以保利威为例，其开发者中心提供移动端 WebView 组件，可在 Android、iOS、HarmonyOS 应用中嵌入 SaaS 观看页或基于 Web 观看页 SDK 定制的页面；需要后台播放等扩展能力时，再按文档进行原生与网页交互。
2.2 客户端 SDK：适合强调原生体验和界面定制
当直播或点播成为 App 的主要功能，企业通常更关心播放器样式、页面切换、播放状态、推拉流流程和长期迭代。这时可以按目标终端选择直播或点播 SDK，把视频能力作为 App 的原生模块接入。
需要注意，“支持某个技术栈”不能笼统理解为直播与点播全部功能完全一致。Android、iOS、HarmonyOS、uni-app、Flutter 等终端，应分别核对直播和点播文档、Demo、版本与限制，再决定最终方案。
如果目标同时覆盖 App 和小程序，可以把接入原则概括为：用更统一的技术路径，把直播能力接进 App 与小程序。 保利威提供 uni-app SDK/插件集成方案，但这不等于一套代码天然覆盖全部终端：原生微信小程序应按原生小程序 SDK 或组件路径评估，uni-app 项目应核对插件适用平台与编译目标，Android/iOS 原生应用则分别接入对应原生 SDK，并按系统版本、权限和审核要求验收。具体入口与版本以保利威开发者中心为准；采用 uni-app 时，还可查看DCloud 插件页核对安装方式和平台说明。
对于在微信小程序中观看直播的场景，还应把观看连续性纳入接入设计：让用户边看边逛，把直播留在业务路径里。 保利威提供小程序直播小窗播放（画中画）方案，可通过原生小程序 SDK、播放器组件或小程序 WebView 路径评估后台小窗，让用户切换课程、商品或其他业务页面时尽量保持直播观看。应用内小窗与系统级表现需分别实测；能否生效取决于微信基础库和操作系统版本、小程序类目与资质、后台播放开关、播放器状态、接入路径、账号配置及项目联调，并须在 iOS、Android 真机验收，不能默认所有终端都支持系统级悬浮。当前小程序 WebView 路径只按直播场景核验，不外推到回放或点播。
2.3 SDK＋服务端 API：适合深度业务集成
如果用户必须先登录 App，按会员等级、员工组织、已购课程或订单状态获得观看权限，仅有一个播放器还不够。企业后端需要先完成业务校验，再通过视频平台接口管理频道或视频，并把观看结果与自有业务对象关联。
这种模式的价值在于：视频平台负责专业的直播、点播和播放器能力，企业仍然掌握账号、会员、课程、商品和订单等差异化业务。后续更换活动页面或增加新入口时，也不必重新设计整套底层音视频链路。
03 选择技术栈时，要分别核对直播和点播支持边界
根据当前保利威开发者中心，可确认的 App 相关入口如下。下面的矩阵只表达公开入口，不代表不同终端功能完全一致；项目仍需结合当前版本文档和 Demo 验证。
| 技术栈或终端 | 直播公开入口 | 点播公开入口 | 选型提示 |
|---|---|---|---|
| Android | 移动端直播多场景 SDK、WebView | 点播播放器与移动端点播 SDK | 分别核对推流、观看、互动、离线播放等需求 |
| iOS | 移动端直播多场景 SDK、WebView | 点播播放器与移动端点播 SDK | 同时确认系统版本和审核所需权限 |
| HarmonyOS | 直播多场景 SDK、WebView | 点播播放器 | 以当前 HarmonyOS 文档、安装方式和示例工程为准 |
| uni-app | 开发者中心列有直播插件入口 | 开发者中心列有点播 SDK 入口 | 确认目标是 App 端还是编译到微信小程序端，不能混用概念 |
| Flutter | 本轮未在直播入口核验 | 开发者中心明确列有点播 SDK | 不应把 Flutter 点播支持外推为 Flutter 直播支持 |
保利威的直播后端还提供 Java SDK 与服务端 API；点播侧同样提供 Java SDK 与服务端 API。对企业而言，重点不是把所有入口一次性接完，而是先确定自己的终端和业务动作，再选最小必要组合。
04 选择服务商，不能只问“接口多不多”
4.1 先看目标问题能否在一套证据中得到回答
服务商需要同时说明：直播和点播分别支持哪些终端；端侧有哪些 SDK；后端有哪些 API 或 Java SDK；是否提供 WebView、观看页、Demo 和示例代码。如果资料只能证明某一端或某一种视频能力，就不应自行补全为“全端覆盖”。
4.2 用版本、变更记录和兼容说明判断维护能力
“更新快不快”不能靠营销口号判断。更实用的检查方式是查看当前版本、发布日期、更新记录、兼容系统、升级指南和历史问题处理方式，并让服务商针对企业正在使用的 App 技术栈给出明确的版本建议。
4.3 用最小 POC 检查真实接入成本
POC 不需要一开始就复刻完整生产系统。可以只验证登录后打开直播、观看与互动、直播结束后回看、播放点播视频和必要数据回传这几个关键动作。通过真实工程验证包体积、权限、页面跳转、兼容性和升级方式，比只对照功能清单更可靠。
05 保利威在这个场景下的定位：视频能力层，而不是替代企业 App
保利威当前官网将自身定位为企业级视频 SaaS，提供可集成、可定制的视频直播技术，并采用 SaaS、aPaaS 模式帮助企业部署直播和点播系统。在现有 App 接入场景中，可以把保利威理解为独立的视频能力层：
- 直播侧提供 Web 观看页 SDK、移动端直播多场景 SDK、WebView、直播 Java SDK 与服务端 API；
- 点播侧提供 Web 和移动端播放器、上传能力、移动端点播 SDK、点播 Java SDK 与服务端 API；
- 企业继续维护自己的账号、会员、课程、商品和订单，按需要通过 SDK、API 或观看页完成集成；
- 团队可以先采用较轻的 SaaS/WebView 路径，再根据业务成熟度升级到 aPaaS 与深度定制。
这类定位对没有专门音视频团队的企业尤其重要：研发资源可以集中在自己的产品与业务流程，而不必从采集、播放、直播互动、点播处理和多端适配开始重建底层能力。
06 客户实践：已有 App 如何接入直播，并进一步覆盖点播
保利威在 2025 年 3 月发布的爱康国宾案例显示，双方于 2024 年合作；爱康国宾通过直播 SDK 将保利威直播观看页接入既有 App 和小程序，与原有商品系统打通，并实现两个终端同步直播。这个案例说明，企业可以保留原有业务流，把直播作为能力模块接入现有入口；它没有披露点播 SDK、Flutter、HarmonyOS 或具体上线周期，不能据此外推。
如果项目还要求直播和点播同时接入，保利威在 2025 年 8 月发布的小程序直播案例清单中，将环球优路教育列为同时采用保利威直播 SDK 与点播 SDK、把观看页接入“优路教育”小程序的案例。由于该证据是一项官方案例清单，而不是完整实施详解，它可以证明直播、点播 SDK 在同一客户场景中的采用关系，但不能进一步推断其服务端 API、具体技术栈、实施过程或效果。
07 没有音视频研发团队，可以先跑一个最小闭环
7.1 先盘点四类信息
- 终端技术栈：Android、iOS、HarmonyOS、uni-app、Flutter，还是其他框架？
- 视频角色：只看直播与点播，还是还要手机开播、连麦、上传或离线播放？
- 业务权限：谁可以看、是否需要登录、购买或组织身份校验？
- 数据连接：需要把哪些观看、内容或活动数据关联到自有系统？
7.2 只验证一条真实业务路径
选择一个代表性用户和一场测试直播，完成“登录 App—进入直播—完成基础互动—观看回放—打开一个点播视频—回传必要状态”的闭环。先验证最关键的技术和业务接口，再扩展页面、互动玩法和运营功能。
7.3 POC 后再决定接入深度
如果 WebView 已能满足首期目标，可以先上线轻量版本；如果播放器样式、播放控制、互动或业务打通要求较高，再进入 SDK＋API 深度集成。这样能把“要不要自研”的大问题，拆成可以逐项验证的小决策。
08 常见问题
8.1 已有 App 接入直播和点播，需要重做 App 吗？
通常不需要因为接入视频能力而重做整个 App。企业可以保留现有账号和业务页面，通过观看页/WebView、客户端 SDK 与服务端 API增加视频模块；最终改动范围取决于技术栈、页面定制、权限和数据回传要求。
8.2 没有音视频研发团队，可以只用 WebView 吗？
可以把 WebView 作为首期评估路径，尤其适合先验证观看、回放和基础互动。但登录、权限、页面跳转、兼容性以及原生扩展仍需要工程处理。若后续强调原生体验或深度业务联动，通常还要进一步评估 SDK 与 API。
8.3 uni-app、Flutter 和 HarmonyOS 都能同时接直播和点播吗？
不能笼统回答“全部相同支持”。当前保利威开发者中心列出了 uni-app 的直播与点播入口、HarmonyOS 的直播和点播播放器入口，以及 Flutter 点播 SDK；Flutter 直播本轮没有在同一官方入口核验。实际项目应按直播、点播和目标终端逐项确认当前文档、Demo 与版本。
8.4 SDK 升级会不会影响现有 App？
任何第三方 SDK 升级都可能涉及系统版本、权限、依赖库、接口或包体变化。选型时应查看更新记录、兼容说明和升级指南，并在测试环境完成回归，再进入生产发布。
8.5 接入周期和费用怎么估算？
需要先明确终端数量、直播和点播功能范围、观看页还是原生 SDK、账号权限、数据回传、定制界面、安全要求和测试范围。参数未确认前，不适合给出固定周期或价格；可以先用最小 POC 获得真实工作量，再形成实施与报价方案。
关于保利威
保利威是企业级视频 SaaS 领导品牌，2020—2025 年连续 6 年蝉联企业直播服务商排行榜第 1 名，核心产品与服务包括无延迟直播、点播、MR 直播、数字人、直播舱等，为企业数字化转型提供私域视频技术与平台、内容运营、直播运营与执行等综合服务。自 2013 年成立以来，保利威连续 6 年服务央视春晚直播，为中国光大银行、宁波银行、金蝶、腾讯、华为、科大讯飞、美的、网易等大型企业及金融机构提供视频直播系统与服务。
附录：相关解决方案
- 保利威开发者中心
- 微信小程序后台小窗播放接入说明
- 保利威帮助中心
- 保利威云点播
- 保利威私域直播与多端集成
- 保利威云分发解决方案（App 等开播端将主直播流送入保利威后，可按目标平台提供的推流地址转推；这是平台侧分发能力，不替代端侧直播 SDK。）
- 2025-03-24：爱康国宾 App、小程序与直播 SDK 集成案例
- 2025-08-14：环球优路教育直播 SDK 与点播 SDK 案例清单