功能：使用webview的方案，在App中实现视频/直播的悬浮小窗播放效果，支持应用内小窗、系统小窗，在订单页小窗播放，回到直播间小窗消失场景：适用于要在App中快速实现直播带货场景，或在App中需要点播视频小窗播放的场景支持环境：安卓、iOS、鸿蒙前置条件：使用保利威的webview SDK Demo

1.1 集成简介

1.1.1 项目架构图

1.1.2 使用源码项目集成

当前将提供的源码包中的PolyvAndroidWebViewDemo、PLVWebViewSDK、PLVJsBridge、PLVFloatWindow四个项目放入到同一目录下，然后使用编译器打开PolyvAndroidWebViewDemo项目即可。

1.1.3 源码集成注意事项

功能对接说明

参考 1.2 功能对接文档

更换通信协议

如果需要更换web-native通信协议的情况时，可以参考提供的  1.3 更换web-native通信规则注意事项

1.2 功能对接文档

1.2.1 功能设置

设置Url和 UA

在启动PLVWebViewDemoActivity之前，我们需要设置加载的Url和添加上需要用到的Ua，这里可以通过来进行设置，示例代码如下：

设置小窗边框颜色

当前SDK支持设置小窗边框颜色，通过进行设置，示例代码如下：

1）设置小窗边框厚度

当前SDK支持设置小窗边框颜色，通过进行设置，示例代码如下：

2）设置自动开启小窗功能

当进程退到后台时会自动唤出小窗(默认关闭)，通过进行设置，示例代码如下：

3）使用系统/应用小窗

当前小窗支持系统小窗和应用窗(默认使用系统小窗)，如果开启系统小窗需要请求小窗悬浮权限，而应用小窗不需要请求权限，注意应用小窗依赖于Activity，当Activity被销毁时，应用小窗也会被关闭。

4）使用原生/web弹出请求权限窗

当前sdk支持通过原生或web端来弹出请求悬浮权限弹窗（默认使用原生弹窗方式）。

注意如果是选择使用web端来弹窗请求悬浮权限弹窗，需要web端支持对应的事件。

1.2.2 监听方法 js 事件

SDK内部已经定义了一部分与web端通信的js事件，这些通信事件可以在demo层中重写某些方法进行监听和拦截处理，这里以监听onShare事件进行为例：

可以选择需要监听的js事件进行重写实现对事件的监听。

允许的监听 js 事件

当前支持通过重写方法来监听事件；

有以下这些方法：

1.2.3 注册新的 js 通信事件

SDK支持注册自定义js事件，可以通过下面的方式来注册自定义js事件，示例代码如下：

1.3 更换web-native通信规则注意事项

1.3.1 说明

当前SDK内部是通过Jsbridge该库来实现web端与原生端的通信，Jsbridge中定义了web端与原生的通信规则，如果集成项目是没有制定指定的web-native通信规则，那么可以直接使用SDK的通信规则即可，无需其余改动。

如果集成项目中有定制指定的web-native通信规则，可以参考下面的方式进行修改。

无论是使用哪一种通信规则，关键在于原生端发送/接收web端消息，web端发送/接收原生端消息，所以当需要更换SDK内部的web-native通信规则仅关注上述的两点即可。

1.3.2 更换native端通信规则

因为sdk内部是依赖于jsbridge该模块实现web-native通信，当需要更换通信规则时，可以选择不依赖该模块。

1.3.3 更改PLVBaseWebView继承类

可将PLVBaseWebView继承的BridgeWebView更换为集成项目中指定通信规则的webview。

1.3.4 更改WebViewClient

WebViewClient是实现原生端接收web端消息的关键，也是定制修改webview的核心部份，所以在更换通信规则时也需要更换WebViewClient

可以通过setWebViewClient(new WebViewClient() 方法为webview设置指定WebViewclient。

1.3.5 更改原生端发送/接收web端消息的方法

更换发送消息方式

当前SDK内部时通过webview.callHandler()方法来实现消息的发送，当更换新的通信规则时，可以将这个webview.callHandler()方法替换为新规则中对应原生端发送消息的方法。

更换接收web端消息

当前SDK内部是通过 webview.registerHandler()方法来监听web端发送的消息，当更换新的通信规则时，可以将这个webview.registerHandler()方法替换为新规则中对应原生端接收web消息的方法。

1.3.6 更换web端通信规则

web-native通信规则是由web端和原生端两端定制的，所以当更换web-native通信规则不仅需要原生端更换，web端也需要进行更换。

注意事项

当前需要通信的 web页面 与 更换通信规则后的原生端 所使用的通信规则是否是对应，如果是对应的情况下无需做其他更替。

如果需要通信的web页面与 更换通信规则后的原生端 所使用的不对应，那么就需要去更替web端的通信规则。

1.3.7 更换web端发送/接收方法

1.更改web端发送消息方式

当前SDK内部与Web端对应的通信规则是通过bridge.callHandler()方法来进行发送消息，当替换新的通信规则后，可以使用新的发送方式来取代这个bridge.callHandler()方法

2.更改web端接收消息方式

当前SDK内部与Web端对应的通信规则是通过bridge.registerHandler()方法来接收消息，当替换新的通信规则后，可以使用新的发送方式来取代这个bridge.registerHandler()方法

2.1 集成简介

2.1.1 项目架构图

2.1.2 运行环境要求

2.1.3 API文档

详细接口文档请参见 API文档

2.2 快速集成

2.2.1 项目配置

配置支持系统版本天津津门虎比赛分析

打开项目的 PROJECT - Deployment Target - iOS Deployment Target 改为 9.0 或更高。

打开项目的 TARGETS - General - Deployment Info，把 iOS 系统改为 9.0 或更高。

2.2.2 配置 App Transport Security (ATS)

打开项目的 文件，添加如下内容：

2.2.3 配置设备旋转

播放器支持全屏播放，需要在 TARGETS - General - Deployment Info 中，勾选支持的横屏旋转方向。

2.2.4 配置后台播放和画中画

打开项目的 TARGETS - Signings & Capabilities，点击 + Capability，选择 Background Modes，勾选 ‘Audio, AirPlay, and Picture in Picture’。

2.3 集成 SDK

2.3.1 Pod方式集成

集成PLVWebViewSDK

在 Podfile 文件中，添加以下内容：

在终端执行 

集成系统小窗

如果需要使用系统小窗功能，则需要在 Podfile 文件中另外添加以下内容

并在终端执行 ，并且将对应的  进行替换。

2.3.2 离线包方式集成

集成PLVWebViewSDK

将 PLVWebViewSDK.framework 库添加到自己的项目中。如果是使用源码的方式集成，则需要将 PLVWebViewSDK 文件整个添加到自己的项目即可。

集成系统小窗

1.如果项目使用系统小窗功能则需要将以下库添加到项目中

2.在General => Frameworks，Libraries，and Embedded Content中移除已添加的 PLVFoundationSDK.framework、PLVLiveScenesSDK.framework、PLVBusinessSDK.framework 库，并添加系统库 libresolv.tbd。

3.设置PLVIJKPlayer为Embed & Sign

4.Build Settings，Other Linker Flags中添加 -ObjC，如果项目已配置有，则不需要重复添加

5.运行报错

如果模拟器运行报错需要在Build Settings 中设置Excluded Architecture => Any iOS Simulator SDK 为 arm64

如果运行报错

可在Build Settings 中 设置 VALIDATE_WORKSPACE 为 YES即可。

2.4 WebView接入

创建想要展示 WebView 的控制器页面  继承于，并通过初始化方法 创建控制器页面。示例代码如下：

初始化时可通过重写  进行自定义配置，同时可以对Bridge事件进行自定义处理。示例代码如下：

创建、配置、打开直播页面控制器

2.5 高级功能

2.5.1 WebView 配置

创建 PLVWebViewBaseViewController 时需要根据 PLVWebViewConfig 配置来进行初始化。

allowFloatingWindow 是否允许使用浮窗的功能isSystemFloatingWindow 使用系统小窗或者应用内小窗userAgent 浏览器的UA，可自行修改enableAutoFloatWindow 开启自动浮窗，开启后 在退出页面或者退到后台时会自动开启小窗

2.5.2 应用内小窗配置

我们还可以对浮窗的大小、默认位置、以及样式进行配置修改：

其中，调用  方法主动唤起的浮窗，默认宽度为屏幕的0.3倍，宽高比16:9。通过保利威的网页唤起浮窗，浮窗大小由网页告知。初始位置是指浮窗右下角距离屏幕右下角的相对位置，默认为(-10, -100)， 表示悬浮窗右边沿距离屏幕右边沿10pt，下边沿距离屏幕下边沿100pt。

2.5.3 画中画配置

如果要使用画中画功能，首先需要在 Podfile 文件中 添加支持画中画的SDK，然后执行 ；

替换对应的离线包

用提供的离线包 将 Pods 文件夹下对应的SDK进行替换。

2.5.4 UA 和白名单配置

当开启了  后，只有添加了域名白名单的链接才会支持原生与前端的通信，才支持小窗的功能。

同时支持 自定义配置 UA

2.5.5 监听方法 js 事件

在SDK内部已经对一些事件进行了处理，如果想要自定义处理某些事件可以在demo中进行监听拦截处理。示例如下：

2.5.6 注册和调用自定 js 事件

可以通过Demo层注册和调用自定义事件，示例代码如下：

2 .6 更换web-native通信规则注意事项

本项目中使用的是开源库 WebViewJavascriptBridge 来实现web 和 native之间的通信。如果接入的项目中没有用到web-native通信，则不需要做任何调整。如果接入的项目中也用到web-native通信，则可以参考下面的方式进行修改。

2.6.1 更换native端通信规则

SDK中使用的 WebViewJavascriptBridge 来实现通信的，在 PLVFloatableWebViewBridge 中对其进行了封装处理，如果需要更换native端通信规则只需要修改 PLVFloatableWebViewBridge 这个类即可

更换注册消息方式:

更换发送web端消息

2.6.2 更换web端通信规则

当native端通信规则改变时，web端则要根据是否与原来的通信方式原理相同来判断是否需要修改。

当前web端注册消息方式

当前web端发送消息方式

当前web-native的通信是通过 bridge 这种方式来发送和接收消息的，如果需要调整可用集成项目web端接收、发送消息的方式来进行替换。

2.7 iOS 系统版本使用系统小窗功能说明

iOS因为系统限制想实现系统小窗只能通过画中画的功能，同时这个功能会有版本限制，在iOS14+开始支持iPhone的画中画功能。同时直播如果使用系统播放器 AVPlayer 会有14s+的高延迟，IJKPlayer可以实现低延迟，但是iOS15以上画中画才支持SampleBufferLayer，因此如果直播低延迟的话需要iOS15+。

回放视频系统小窗支持iOS14+直播视频系统小窗支持iOS15+

3.1 简介

PLVWebSDK 项目从属于易方信息科技股份有限公司，对保利威云直播、云点播系列产品的直播、回放观看做了良好的适配，极大优化了用户的观看体验，并支持浮窗播放等扩展功能，也可作为其他网页的展示容器。

本项目包含功能如下：

支持基础Web功能支持应用内浮窗播放支持系统级浮窗播放支持悬浮窗手势拖动支持视频全屏播放

3.2 下载安装

OpenHarmony ohpm 环境配置等更多内容，请参考如何安装 OpenHarmony ohpm 包

3.3 需要权限

3.4 使用示例

3.4.1 绑定WindowStage

首先需要在Ability中为PLVWebViewWindowManager绑定用到windowStage

3.4.2 使用PLVWeb组件

3.4.3 Demo使用

为PLVWebViewWindowManager绑定了WindowStage后，可以通过 来进行初始化化，如果传入参数true时，当初始化后立刻展示WebWindow，也可以选择传入false，初始化后不立刻展示WebWindow 再通过来进行展示

3.5 功能说明

3.5.1 PLVWebViewConfig

1.设置UA

当前可以通过下面的方式来设置需要的UA

注意：如果需要到Saas页面的小窗功能的情况，必须在UA中带上Android和PLVUAConfig.defaultUA字段

2.设置url

可以通过下面的方式来设置需要加载的url

PLVWebViewConfig().setUrl("需要加载的url")

3.设置是否允许小窗悬浮

可以通过下面的方式来设置是否允许开启小窗功能，默认是开启的，如不需要可以设置为false

3.5.2 自定义注册事件

当前SDK内部已经注册好与前端页面通信的事件，当接入sdk后就能直接使用这些事件。

SDK也支持注册自定义事件，可以通过下面的方式来进行注册

如果需要监听/拦截SDK内部已经实现了的事件，可以通过下面的方式继续监听/拦截，这里以onShare事件为例子，如果需要监听/拦截其他事件可以仿照这里来完成

clickProduct事件 和 clickProductCustom自定义 webviewData ---> data 下面根据 type 和 其他参数完成 app 内链接跳转功能