7.视频投屏

2.17.0及以后

2.17.0 版本开始，投屏功能改为使用幕享投屏实现，整体代码结构与使用方式与 2.16.6 版本相近，Demo 层投屏目录结构如下所示

//com/easefun/polyvsdk/cast
├── PolyvAllCast.java  // 幕享投屏二次封装类
├── PolyvIUIUpdateListener.java  // 封装的投屏状态回调监听器
├── PolyvScreencastManager.java  // 投屏封装工具类，操作投屏功能使用
└── widget
    ├── PolyvScreencastSearchLayout.java  // 搜索投屏Layout
    └── PolyvScreencastStatusLayout.java  // 投屏状态管理Layout

幕享投屏 SDK 依赖包放置在 demo 项目 app 模块的 libs 目录下面，SDK 的依赖引入声明如下

// 投屏sdk
implementation files("libs/wx-commonlib-1.0.1.aar")
implementation files("libs/wx-dlnasdk-1.0.1.aar")
implementation files("libs/wx-dlnasender-1.0.1.aar")
implementation files("libs/wx-jettylib-1.0.1.aar")

1.初始化

public void initScreencast() {
    // TODO appId和appSecret需与包名绑定，获取方式请咨询Polyv技术支持
    PolyvScreencastManager.init(this, <appId>, <appSecret>, new WxDlnaSenderInitCallback() {
        @Override
        public void onSuccess() {
            PolyvCommonLog.i(TAG, "initScreencast success");
            // 初始化单例
            PolyvScreencastManager.getInstance(PolyvApplication.this);
        }
        @Override
        public void onFail(int code, String msg) {
            PolyvCommonLog.i(TAG, "initScreencast fail, code = " + code + ", msg = " + msg);
        }
    });
}

上述方法的用例在PolyvApplication类的initScreencast()方法中使用到。

2. 监听器

监听器可以监听搜索设备的状态，连接的设备的状态，接收端的播放器状态，播放进度等。

// 设置搜索设备状态、接收端播放器状态监听器
screencastManager.setUIUpdateListener(iUIUpdateListener);
// 设置连接设备状态监听器
screencastManager.setActivityConnectListener(iConnectListener);

3. 搜索设备相关方法

// 开始搜索
screencastManager.browse();

搜索设备的成功、失败等状态可以在screencastManager.setUIUpdateListener(iUIUpdateListener)的onUpdateState回调中获取。

4. 获取搜索的设备信息

搜索设备成功后，可以调用以下的方法获取设备信息：

// 获取搜索的设备信息
screencastManager.getInfos();

5. 连接设备相关方法

搜索设备成功后，可以调用以下的方法连接设备：

// 连接设备
screencastManager.connect(info);
// 获取当前已连接的设备
screencastManager.getConnectInfos();

连接设备的成功、失败等状态可以在screencastManager.setActivityConnectListener(iConnectListener)的onConnect回调中获取。

6. 断开连接的设备

使用以下的方法断开当前连接的设备：

screencastManager.stopPlay();
screencastManager.disConnect(selectInfo);

连接其他的设备之前，需要先断开当前连接的设备。

7. 投放视频的方法

连接设备成功后，就可以进行视频投放，视频投放的方法如下：

// 投放非加密视频
screencastManager.playNetMedia(playerInfo);

// 投放加密视频
PolyvScreencastHelper.getInstance().transformPlayObject(mediaInfo, video, bitrate, playPath, new PolyvScreencastHelper.PolyvCastTransformCallback() {
    @Override
    public void onSucceed(Object object, String newPlayPath) {
        play((MediaInfo) object, newPlayPath, bitrate, videoPosition);
    }

    @Override
    public void onFailed(Throwable e) {

    }
});

public void play(MediaInfo playerInfo, String playPath, int bitrate, int seconds) {
    playerInfo.setMediaId(Base64.encodeToString(playPath.getBytes(), Base64.NO_WRAP));
    playerInfo.setUri(playPath);
    playerInfo.setMediaType(MediaInfo.TYPE_VIDEO);
    screencastManager.playNetMedia(playerInfo);
}

加密视频的播放，需要通过PolyvScreencastHelper.getInstance().transformPlayObject 将一系列参数进行转换得到新的playerInfo和播放链接newPlayPath，把他们使用在投屏播放的相关接口即可支持加密视频播放，上面仅是其中示例，更多可参考幕享投屏 SDK。

视频的播放状态、播放进度可以在screencastManager.setUIUpdateListener(iUIUpdateListener)的onUpdateState回调中获取。

8. 播放控制方法

视频开始播放后，可以在投屏发送端对接收端进行播放控制，播放控制有以下的方法：

// 暂停
screencastManager.pause();
// 恢复
screencastManager.resume();
// 快进/退
screencastManager.seekTo(progress);
// 音量调节
screencastManager.volumeUp();
screencastManager.volumeDown();

2.15.0（含）- 2.16.6

点播 SDK 自 2.15.0 起，投屏 sdk 正式转移到 Demo 层。开发者可自行参考Demo，集成乐播投屏SDK，实现投屏功能。此外关于加密视频的投屏播放，需要使用接口转换，详细见下方关于《2.15.0（含）- 2.16.6# 7.播放视频的方法》的集成描述。

关于旧版的点播投屏仍旧可以使用，但投屏sdk不再维护更新。

//不再维护，点播2.15.0起 sdk 功能实现已经转移到Demo层
implementation 'com.easefun.polyv:polyvScreencast:0.3.1'

注意事项：请勿同时使用点播 SDK 2.15.0+ 和旧版投屏SDK，否则会有冲突

2.15.0中Demo集成乐播投屏4.00.13，为兼容Android 10，需将投屏SDK所在service设置为前台服务，故乐播投屏在4.0+开始要求开发者设置compileSdkVersion 29 ,一般情况要求targetSdkVersion总是小于或等于compileSdkVersion

如果是旧版投屏 SDK 升级的，可以移除投屏依赖，直接复制 Demo 层代码和 lib 中的投屏 aar。PolyvScreencastManager 等同于旧版的 PolyvScreencastHelper，可以参考使用，投屏播放url请参考本小节中《7.播放视频的方法》，查看变更内容。

新集成的开发者可以忽略，直接移植相关Demo代码，或者自行集成乐播SDK，进行投屏播放。播放加密视频需要参考本小节中《7.播放视频的方法》。

Demo层投屏目录结构如下所示

//com/easefun/polyvsdk/cast
├── PolyvAllCast.java //乐播投屏二次封装类
├── PolyvIUIUpdateListener.java // 封装的投屏状态回调监听器
├── PolyvScreencastManager.java //投屏封装工具类，操作投屏功能使用。等同于旧版的PolyvScreencastHelper
└── widget
    ├── PolyvScreencastSearchLayout.java //搜索投屏Layout
    └── PolyvScreencastStatusLayout.java //投屏状态管理Layout

1.初始化

//appId和appSecret需与包名绑定，获取方式请到乐播官网注册获取
PolyvScreencastManager.init(<AppId>, <AppSecret>);
//初始化单例
PolyvScreencastManager.getInstance(this);

上述方法的用例在PolyvApplication类的initScreencast()方法中使用到。

2. 监听器

监听器可以监听搜索设备的状态，连接的设备的状态，接收端的播放器状态，播放进度等。

//设置搜索设备状态、接收端播放器状态监听器
screencastManager.setUIUpdateListener(iUIUpdateListener);
//设置连接设备状态监听器
screencastManager.setActivityConenctListener(iConnectListener);

3. 搜索设备相关方法

//开始搜索
screencastManager.browse();
//停止搜索
screencastManager.stopBrowse();

搜索设备的成功、失败等状态可以在screencastManager.setUIUpdateListener(iUIUpdateListener)的onUpdateState回调中获取。

4. 获取搜索的设备信息

搜索设备成功后，可以调用以下的方法获取设备信息：

//获取搜索的设备信息
screencastManager.getInfos();

5. 连接设备相关方法

搜索设备成功后，可以调用以下的方法连接设备：

//连接设备
screencastManager.connect(info);
//获取当前已连接的设备
screencastManager.getConnectInfos();

连接设备的成功、失败等状态可以在screencastManager.setActivityConenctListener(iConnectListener)的onConnect回调中获取。

6. 断开连接的设备

使用以下的方法断开当前连接的设备：

screencastManager.stopPlay();
screencastManager.disConnect(selectInfo);

连接其他的设备之前，需要先断开当前连接的设备。

7. 投放视频的方法

连接设备成功后，就可以进行视频投放，视频投放的方法如下：

//投放非加密视频
screencastManager.playNetMedia(playPath, PolyvAllCast.MEDIA_TYPE_VIDEO, "");
screencastManager.playNetMediaWithPosition(playPath, PolyvAllCast.MEDIA_TYPE_VIDEO,  seconds);
...
//投放加密视频
PolyvScreencastHelper.getInstance().transformPlayObject(lelinkPlayerInfo, video, bitrate, playPath, new PolyvScreencastHelper.PolyvCastTransformCallback() {
  @Override
  public void onSucceed(Object object, String newPlayPath) {
		        screencastManager.playNetMedia((LelinkPlayerInfo) object, playPath, PolyvAllCast.MEDIA_TYPE_VIDEO, "", seconds);
  }

  @Override
  public void onFailed(Throwable e) {

  }
});

目前连接设备成功后，需要延迟3秒才能进行视频投放，否则投放加密视频可能会失败。

加密视频的播放，需要通过PolyvScreencastHelper.getInstance().transformPlayObject将一系列参数进行转换得到新的lelinkPlayerInfo和播放链接newPlayPath，把他们使用在投屏播放的相关接口即可支持加密视频播放，上面仅是其中示例，更多可参考乐播投屏SDK。注意这里进行转换的是点播SDK里面的PolyvScreencastHelper,请勿同时集成旧版投屏SDK。

视频的播放状态、播放进度可以在screencastManager.setUIUpdateListener(iUIUpdateListener)的onUpdateState回调中获取。

8. 播放控制方法

视频开始播放后，可以在投屏发送端对接收端进行播放控制，播放控制有以下的方法：

//暂停
screencastManager.pause();
//恢复
screencastManager.resume();
//快进/退
screencastManager.seekTo(progress);
//音量调节
screencastManager.voulumeUp();
screencastManager.voulumeDown();

2.15.0以前

1. 初始化

//appId和appSecret需与包名绑定，获取方式请到乐播官网注册获取
PolyvScreencastHelper.init(<appKey>, <appSecret>);
//初始化单例
PolyvScreencastHelper.getInstance(this);

上述方法的用例在PolyvApplication类的initScreencast()方法中使用到。

2. 监听器

监听器可以监听搜索设备的状态，连接的设备的状态，接收端的播放器状态，播放进度等。

//设置搜索设备状态、接收端播放器状态监听器
screencastHelper.setUIUpdateListener(iUIUpdateListener);
//设置连接设备状态监听器
screencastHelper.setActivityConenctListener(iConnectListener);

3. 搜索设备相关方法

//开始搜索
screencastHelper.browse(type);
//停止搜索
screencastHelper.stopBrowse();

搜索设备的成功、失败等状态可以在screencastHelper.setUIUpdateListener(iUIUpdateListener)的onUpdateState回调中获取。

4. 获取搜索的设备信息

搜索设备成功后，可以调用以下的方法获取设备信息：

//获取搜索的设备信息
screencastHelper.getInfos();

5. 连接设备相关方法

搜索设备成功后，可以调用以下的方法连接设备：

//连接设备
screencastHelper.connect(info);
//获取当前已连接的设备
screencastHelper.getConnectInfos();

连接设备的成功、失败等状态可以在screencastHelper.setActivityConenctListener(iConnectListener)的onConnect回调中获取。

6. 断开连接的设备

使用以下的方法断开当前连接的设备：

screencastHelper.stop();
screencastHelper.disConnect(selectInfo);

连接其他的设备之前，需要先断开当前连接的设备。

7. 投放视频的方法

连接设备成功后，就可以进行视频投放，视频投放的方法如下：

//投放非加密视频
screencastHelper.playNetMedia(playPath, PolyvAllCast.MEDIA_TYPE_VIDEO, "");
//投放加密视频
screencastHelper.playNetMedia(playPath, videoVO.getVid(), bitrate, videoVO.getSeedConst(), PolyvAllCast.MEDIA_TYPE_VIDEO, "");

目前连接设备成功后，需要延迟3秒才能进行视频投放，否则投放加密视频可能会失败。

视频的播放状态、播放进度可以在screencastHelper.setUIUpdateListener(iUIUpdateListener)的onUpdateState回调中获取。

8. 播放控制方法

视频开始播放后，可以在投屏发送端对接收端进行播放控制，播放控制有以下的方法：

//暂停
screencastHelper.pause();
//恢复
screencastHelper.resume();
//快进/退
screencastHelper.seekTo(progress);
//音量调节
screencastHelper.voulumeUp();
screencastHelper.voulumeDown();

Previous6 视频上传 Next8 三分屏播放

Last updated 1 year ago

Was this helpful?