Table of Contents SDK 简介文档版本说明阅读对象支持系统版本整体结构图播放器 VideoView 关系图播放器 Player 关系图 SDK 名词解释播放器功能篇支持播放的格式 SDK 接入篇云点播云直播视频下载应用混淆全景功能解析水印功能使用播放器状态篇应用白名单 FAQ\(

Transcription

1 Table of Contents SDK 简介文档版本说明阅读对象支持系统版本整体结构图播放器 VideoView 关系图播放器 Player 关系图 SDK 名词解释播放器功能篇支持播放的格式 SDK 接入篇云点播云直播视频下载应用混淆全景功能解析水印功能使用播放器状态篇应用白名单 FAQ\( 问答 \) 更新说明

2 什么是乐视云播放 SDK 乐视云播放 SDK 是基于 Android 4.1 及以上版本设备提供的云视频服务接口 依托于强大的乐视云网络视频应用平台, 您可以使用该 SDK 开发内容丰富的 Android 端移动视频应用 乐视云 SDK 支持的业务如下 : 云点播云直播点播视频下载

3 文档版本说明 版本号版本说明修改者更新日期 4.4 播放 SDK 文档高林花

4 面向的读者 乐视云 SDK 是提供给具有一定 Android 编程经验的开发者使用 您在使用中, 遇到任何问题, 都可以通 过乐视云支持中心反馈给我们

5 兼容性 1. Android 版本 4.1 及以上 2. CPU 类型支持 armeabi armeabi-v7a arm64-v8a 3. 适配市场大部分手机型号

6 整体结构主要从两个方面介绍 :(1)IPlayer 层, 用户可以从该层接入 ; (2)IVideoView 层, 在该层我们封装了 SurfaceView, 用户需要实现的代码量 较少

7 播放器 VideoView 关系图 播放器 VideoView 接口与类的关系图如下 :

8 播放器 Player 关系图 播放器 Player 接口与类的关系图如下 :

9 播放 SDK 相关词语解释 云点播 : 云点播支持根据 UU VU 去请求相应的视频资源播放 ; 也支持 Url 直接播放 点播参数 UU: 登录乐视云官网 --> 用户中心 --> 用户私钥 -->UUID 点播参数 VU: 代表视频 id, 成功上传视频到乐视云官网, 查看 VU 值, 控制台 --> 云点播 --> 视频 --> 视频管理 --> 代码 -->VU 点播参数 PU: 获取自定义水印需要用到, 是播放器 ID, 具体请参考水印功能使用点播参数 Path: 传给播放器 url, 可以直接播放云直播 : 根据活动 ID 请求相应的直播视频资源播放云直播参数 ActionId: 在官网云直播模块, 创建活动即可生成活动 ID 云直播参数 PU: 获取自定义水印需要用到, 是播放器 ID, 具体请参考水印功能使用移动直播 : 根据 Url 请求相应的视频资源播放移动直播参数 Path: 传给播放器 url, 可以直接播放

10 播放器支持的功能介绍 点播功能 : 暂停 播放 快进 回退 横竖屏切换 码率切换 横屏时触摸调节屏幕亮度 横屏时触摸调节音量 锁定横屏 全景播放视频云直播功能 : 播放 结束播放 回看 回到最新直播 横竖屏切换 码率切换 横屏时触摸调节屏幕亮度 横屏时触摸调节音量 锁定横屏 全景播放视频

11 支持播放的视频格式 说明 : 播放器能否成功播放某个视频, 取决于 3 个因素 : 传输协议 封装格式 编码格式 ; 乐视播放 SDK 支持格式如下所示 : (1) 传输协议 :hls,rtmp,rtsp,http,https,file (2) 封装格式 :mp4,ts,mp3,flv (3) 音频编码格式 :aac,pcm_mulaw,mpegaudio (4) 视频编码格式 :h264

12 项目集成 在 AndroidStudio 中, 把我们的播放 sdk 集成到你的项目中, 需按以下步骤接入, 每个步骤都不可省略 : (1) 创建自己的工程 (2) 将 LePlayerDemo 工程下 assets 下面的 arkapsconf.json,sdkconfig.xml, 以及文件夹 ad_jars, 拷贝到你自己工程的 assets 目录下面 (3) 如果使用有皮肤播放 : 直接依赖皮肤工程 LePlayerSkin, 皮肤工程依赖 LePlayerSdk ; 如果使用无皮肤版本, 直接依赖 LePlayerSdk (4) 在工程中的 application 中添加下面代码 : public void oncreate() { super.oncreate(); String processname = getprocessname(this, android.os.process.mypid()); // 设置域名 LeCloudPlayerConfig.HOST_DEFAULT 代表国内版 //LeCloudPlayerConfig.HOST_US 代表国际版 //LeCloudPlayerConfig.HOST_GUOGUANG 代表国广版 // 国内用户都使用默认的 LeCloudPlayerConfig.HOST_DEFAULT int host = LeCloudPlayerConfig.HOST_DEFAULT; if (getapplicationinfo().packagename.equals(processname)) { //CrashHandler 是一个抓取崩溃 log 的工具类 ( 可选 ) CrashHandler.getInstance(this); try { LeCloudPlayerConfig.setHostType(host); LeCloudPlayerConfig.init(getApplicationContext()); LeCloudPlayerConfig.setmInitCmfListener(new OnInitCmfListener() { public void oncdestartsuccess() { //cde 启动成功, 可以开始播放 // 如果使用 remote 版本这个方法会回调的晚一些, 因为有个下载过程 // 只有回调了该方法, 才可以正常播放视频 ( 点播, 直播 ) // 建议用户通过 cde 初始化的回调进行控制, 点击开始播放是否创建播放器 public void oncdestartfail() { // 如果使用 remote 版本则可能是 remote 下载失败 ; // 如果使用普通版本, 则可能是 so 文件加载失败导致 public void oncmfcoreinitsuccess() { // 不包含 cde 的播放框架需要处理

13 public void oncmfcoreinitfail() { // 不包含 cde 的播放框架需要处理 ); public void oncmfdisconnected() { //cde 服务断开, 会导致播放失败, 重启一次服务 try { LeCloudPlayerConfig.init(getApplicationContext()); catch (Exception e) { e.printstacktrace(); catch (Exception e) { // TODO Auto-generated catch block e.printstacktrace(); // 获取当前进程名字 public static String getprocessname(context cxt, int pid) { ActivityManager am = (ActivityManager) cxt.getsystemservice(context.activity_service); List<RunningAppProcessInfo> runningapps = am.getrunningappprocesses(); if (runningapps!= null) { for (RunningAppProcessInfo procinfo : runningapps) { if (procinfo.pid == pid) { return procinfo.processname; return null; (5) 在工程的 AndroidManifest.xml 中添加所需权限 :

14 <uses-permission android:name="android.permission.internet" /> <uses-permission android:name="android.permission.access_network_state" /> <uses-permission android:name="android.permission.access_wifi_state" /> <uses-permission android:name="android.permission.write_external_storage" /> <uses-permission android:name="android.permission.read_external_storage" /> <uses-permission android:name="android.permission.mount_unmount_filesystems" /> <uses-permission android:name="android.permission.access_fine_location" /> <uses-permission android:name="android.permission.access_coarse_location" /> <uses-permission android:name="android.permission.modify_audio_settings" /> <uses-permission android:name="android.permission.vibrate" /> <uses-permission android:name="android.permission.read_logs" /> <uses-permission android:name="android.permission.flashlight" /> <uses-permission android:name="android.permission.get_tasks" /> <uses-permission android:name="android.permission.read_phone_state" /> <uses-permission android:name="android.permission.receive_user_present" /> (6) 在工程的 AndroidManifest.xml 中添加服务声明 : <service android:name="com.letvcloud.cmf.mediaservice" android:process=":cmf" /> (7) 如果使用有皮肤播放, 在工程的 AndroidManifest.xml 中添加下面代码 : <activity android:name="com.lecloud.skin.activity.feedbackactivity" android:configchanges="keyboard screensize orientation layoutdirection" android:screenorientation="portrait" android:theme="@android:style/theme.notitlebar" > </activity> (8) 在乐视云官网接入你的应用, 接入步骤如下图 注 : 接入应用之前需要登录乐视云官网, 乐视云登录网址

15 (9) 在完成上述步骤之后, 开始集成云点播 云直播 说明 播放器的接入方式有三种 (demo 中我们主要介绍无皮肤接入和有皮肤接入 ): (1)IPlayer 层接入, 参考 IVideoView 的无皮肤实现和有皮肤实现 (2)IVideoView 无皮肤播放接入 (3)IVideoView 有皮肤播放接入

16 云点播功能说明 乐视云点播接口, 可以将您预先上传到乐视云服务器的视频资源, 在 Android 端在线播放 关于视频上传请参考云点播 - 快速使用 SDK 云点播接口使用 1 添加播放器 点播播放器分为有皮肤 ( UIVodVideoView ) 有皮肤全景( UIPanoVodVideoView ) 和无皮肤 ( VodVideoView ) 三种类型在目标界面代码中, 新建并添加播放器 ( 请勿在布局文件中直接添加播放器 ) private IMediaDataVideoView videoview; protected void oncreate(bundle savedinstancestate) { // 设置窗口透明, 可避免播放器 SurfaceView 初始化时的黑屏现象 getwindow().setformat(pixelformat.translucent); // 视频播放界面, 保持屏幕常亮利于视频观看体验 getwindow().addflags(windowmanager.layoutparams.flag_keep_screen_on); super.oncreate(savedinstancestate); setcontentview(r.layout.video_play); // videocontainer 作为视频播放器的容器使用 RelativeLayout videocontainer = (RelativeLayout) findviewbyid(r.id.videocontainer); // 无皮肤播放器请初始化 VodVideoView // videoview = new VodVideoView(this); // 有皮肤播放器请初始化 UIVodVideoView videoview = new UIVodVideoView(this)); // 有皮肤全景 ( 包括 VR) 播放器请初始化 UIPanoVodVideoView //videoview = new UIPanoVodVideoView(this)); // 将播放器添加到容器中 // 在这儿, 我们使用的是 16:9 的比例适配播放器界面 // 详细请参考 Demo 工程 PlayActivity 布局添加播放器时的 param 配置 RelativeLayout.LayoutParams params = new RelativeLayout.LayoutParams( RelativeLayout.LayoutParams.MATCH_PARENT, RelativeLayout.LayoutParams.MATCH_PARENT); videocontainer.addview((view) videoview, params);

17 video_play 布局文件内容如下 : <?xml version="1.0" encoding="utf-8"?> <RelativeLayout xmlns:android=" android:id="@+id/videocontainer" android:layout_width="match_parent" android:layout_height="203dp" > </RelativeLayout> 2 播放器参数配置 1. 通过 Url 播放视频的参数配置 // Url 可以是在线视频, 也可以是本地视频 // String playpath = "/sdcard/demo.mp4" String playpath = " videoview.setdatasource(playpath); 2. 通过 UUID 和 VUID 播放视频配置 String uuid = "e0bd16c57a"; String vuid = "2276b51876"; String pu = "0"; Bundle mbundle = new Bundle(); // 配置播放类型为点播 mbundle.putint(playerparams.key_play_mode, PlayerParams.Value_PLAYER_VOD); // UUID 和 VUID 配置 mbundle.putstring(playerparams.key_play_uuid, uuid); mbundle.putstring(playerparams.key_play_vuid, vuid); mbundle.putstring(playerparams.key_play_pu, pu); videoview.setdatasource(mbundle); UUID 和 VUID 的值可以通过如下方法获取

18 3 开始播放 处理播放器回调事件 VideoViewListener videoviewlistener = new VideoViewListener() { public void onstateresult(int event, Bundle bundle) { handleplayerevent(event, bundle);// 处理播放器事件 ; videoview.setvideoviewlistener(videoviewlistener); handleplayerevent 的实现为 : /** * 处理播放器本身事件, 具体事件可以参见 IPlayer 类 */ private void handleplayerevent(int state, Bundle bundle) { switch (state) { case PlayerEvent.Play.PREPARED: // 播放器准备完成, 此刻调用 start() 就可以进行播放了 if (videoview!= null) { videoview.onstart(); break; default: break; 4 处理播放器的生命周期

19 protected void onresume() { super.onresume(); videoview.onresume(); protected void onpause() { super.onpause(); videoview.onpause(); protected void ondestroy() { super.ondestroy(); if (videoview!= null) { videoview.ondestroy(); // 在 AndroidManifest.xml 中 Activity 申明时, 需要添加配置 //android:configchanges="keyboard screensize orientation layoutdirection", 以使该回调方法生 public void onconfigurationchanged(configuration newconfig) { super.onconfigurationchanged(newconfig); if (videoview!= null) { videoview.onconfigurationchanged(newconfig); 如果你完全按上述步骤集成点播功能, 那么点播就可以正常播放了 如果你还有什么疑问, 都可以通 过乐视云支持中心反馈给我们, 我们会及时为您解答, 也会将您所提出的具有代表性的问题放到常见 问题里

20 云直播功能说明 乐视云直播, 可将您通过网页或嵌入式智能设备上传的直播视频流进行在线播放 具体如何创建云直播活动, 请参考云直播 - 快速使用 SDK 云直播接口使用 1 添加播放器 直播播放器分为有皮肤 ( UIActionLiveVideoView ) 有皮肤全景( UIPanoActionLiveVideoView ) 和无皮肤 ( ActionLiveVideoView ) 三种类型在目标界面代码中, 新建并添加播放器 ( 请勿在布局文件中直接添加播放器 ) private IMediaDataVideoView videoview; protected void oncreate(bundle savedinstancestate) { // 设置窗口透明, 可避免播放器 SurfaceView 初始化时的黑屏现象 getwindow().setformat(pixelformat.translucent); // 视频播放界面, 保持屏幕常亮利于视频观看体验 getwindow().addflags(windowmanager.layoutparams.flag_keep_screen_on); super.oncreate(savedinstancestate); setcontentview(r.layout.video_play); // videocontainer 作为视频播放器的容器使用 RelativeLayout videocontainer = (RelativeLayout) findviewbyid(r.id.videocontainer); // 无皮肤播放器请初始化 ActionLiveVideoView // videoview = new ActionLiveVideoView(this); // 有皮肤播放器请初始化 UIActionLiveVideoView videoview = new UIActionLiveVideoView(this)); // 有皮肤全景 ( 包括 VR) 播放器请初始化 UIPanoActionLiveVideoView //videoview = new UIPanoActionLiveVideoView(this)); // 将播放器添加到容器中 // 在这儿, 我们使用的是 16:9 的比例适配播放器界面 // 详细请参考 Demo 工程 PlayActivity 布局添加播放器时的 param 配置 RelativeLayout.LayoutParams params = new RelativeLayout.LayoutParams( RelativeLayout.LayoutParams.MATCH_PARENT, RelativeLayout.LayoutParams.MATCH_PARENT); videocontainer.addview((view) videoview, params); video_play 布局文件内容如下 :

21 <?xml version="1.0" encoding="utf-8"?> <RelativeLayout xmlns:android=" android:layout_width="match_parent" android:layout_height="203dp" > </RelativeLayout> 2 播放器参数配置 1. 通过 ActionId 播放视频配置 String mactionid = "A gx"; //musehls = true, 表示使用 hls 协议播放 ;musehls = false, 表示使用 rtmp 协议播放 ; // 默认使用 rtmp 协议播放 private boolean musehls = false; // 根据 pu 获取水印和缓冲片头 String pu = "0"; //cuid,utoken 是直播付费验证需要的两个参数 String cuid = ""; String utoken = ""; Bundle mbundle = new Bundle(); // 配置播放类型为活动直播 mbundle.putint(playerparams.key_play_mode, PlayerParams.Value_PLAYER_ACTION_LIVE); // ActionId 配置 mbundle.putstring(playerparams.key_play_actionid,mactionid); mbundle.putboolean(playerparams.key_play_usehls,musehls); mbundle.putstring(playerparams.key_play_pu, pu); mbundle.putstring(playerparams.key_action_cuid, cuid); mbundle.putstring(playerparams.key_action_utoken, utoken); videoview.setdatasource(mbundle); ActionId 的值可以通过如下方法获取 3 开始播放 处理播放器回调事件

22 VideoViewListener videoviewlistener = new VideoViewListener() { public void onstateresult(int event, Bundle bundle) { handleplayerevent(event, bundle);// 处理播放器事件 ; videoview.setvideoviewlistener(videoviewlistener); handleplayerevent 的实现为 : /** * 处理播放器本身事件, 具体事件可以参见 IPlayer 类 */ private void handleplayerevent(int state, Bundle bundle) { switch (state) { case PlayerEvent.Play.PREPARED: // 播放器准备完成, 此刻调用 start() 就可以进行播放了 if (videoview!= null) { videoview.onstart(); break; default: break; 4 处理播放器的生命周期

23 protected void onresume() { super.onresume(); videoview.onresume(); protected void onpause() { super.onpause(); videoview.onpause(); protected void ondestroy() { super.ondestroy(); if (videoview!= null) { videoview.ondestroy(); // 在 AndroidManifest.xml 中 Activity 申明时, 需要添加配置 android:configchanges="keyboard screen public void onconfigurationchanged(configuration newconfig) { super.onconfigurationchanged(newconfig); if (videoview!= null) { videoview.onconfigurationchanged(newconfig); 如果你完全按上述步骤集成云直播功能, 那么云直播就可以正常播放了 如果你还有什么疑问, 都可 以通过乐视云支持中心反馈给我们, 我们会及时为您解答, 也会将您所提出的具有代表性的问题放到 常见问题里

24 视频下载功能说明 下载模块和乐视云点播业务搭配使用, 可以下载云点播视频到 SD 卡上, 方便用户在无法使用网络的情况下观看视频 点播视频下载接口使用接入步骤如下 : DEMO 中的下载模块案例在 DownloadActivity 中 这里以下载一个点播视频为例进行讲解, 快速对接步骤如下 : // 定义 uuid vuid private String uuid = "3a9d21720d"; private String vuid = "f524458b4f"; // 定义下载列表对象参考类 LeDownloadInfo private List<LeDownloadInfo> mdownloadinfos; // 定义 DownloadCenter 对象, 这个对象就是对视频下载类的封装,DownloadCenter 对象全局只有一个 private DownloadCenter mdownloadcenter; // 实现 LeDownloadObserver 对象,observer 主要用于监听下载过程中的各状态的改变 LeDownloadObserver observer = new LeDownloadObserver() { public void ondownloadsuccess(ledownloadinfo info) { // 下载成功 public void ondownloadstop(ledownloadinfo info) { // 下载暂停 public void ondownloadstart(ledownloadinfo info) { // 开始下载 public void ondownloadprogress(ledownloadinfo info) { // 下载进度通知

25 public void ondownloadfailed(ledownloadinfo info, String msg) { // 下载失败 public void ondownloadcancel(ledownloadinfo info) { // 取消下载 public void ondownloadinit(ledownloadinfo info, String msg) { // 下载初始化 public void ondownloadwait(ledownloadinfo info) { // 当请求视频的 url 成功时, 回调这个方法, 表示开始等待下载 ; public void ongetvideoinforate(ledownloadinfo info, List<String> rates) { // 获取你当前下载视频的码率 ( 比如标清 高清 原画等等 ) protected void oncreate(bundle savedinstancestate) { // 实例化 DownloadCenter 对象 mdownloadcenter = DownloadCenter.getInstances(this.getApplicationContext()); // 向 DownloadCenter 注册 observer; // 一个 DownloadCenter 可以注册多个 observer, 事件会通知每一个 observer; mdownloadcenter.registerdownloadobserver(observer); // 获取所有添加到下载列表中的视频 这里需要注意 : 获取到的列表包括未开始 // 正在下载 已完成 失败等所有状态的视频 mdownloadinfos = mdownloadcenter.getdownloadinfolist(); // 点击下载按钮后调用该方法 mdownloadcenter.downloadvideo("", uuid, vuid); // 点击下载按钮后, 如果不调用 mdownloadcenter.downloadvideo("", uuid,vuid); // 则可以调用该方法, 建议使用该方法 LeDownloadInfo info = new LeDownloadInfo(); info.setuu(uuid); // 必填, 否则不能下载视频 info.setvu(vuid); // 必填, 否则不能下载视频 mdownloadcenter.downloadvideo(info);

26 protected void ondestroy() { super.ondestroy(); if (mdownloadcenter!= null) { mdownloadcenter.unregisterdownloadobserver(observer); 关于视频下载的快速接入, 写入上述代码即可完成, 下面是关于接口和实体类的详细描述 interface LeDownloadObserver 属性 值 说明 int DOWLOAD_STATE_WAITING 0 下载状态 -- 等待中 int DOWLOAD_STATE_DOWNLOADING 1 下载状态 - 下载中 int DOWLOAD_STATE_STOP 2 下载状态 - 下载暂停 int DOWLOAD_STATE_SUCCESS 3 下载状态 - 下载成功 int DOWLOAD_STATE_FAILED 4 下载状态 - 下载失败 int DOWLOAD_STATE_NO_DISPATCH 5 当前视频已经添加到下载队列, 但是没有开始调度 int DOWLOAD_STATE_URL_REQUEST_FAILED 6 视频 url 地址请求失败 int DOWLOAD_STATE_NO_PERMISSION 7 没有权限下载 int DOWLOAD_STATE_DISPATCHING 8 正在调度中 int DOWLOAD_STATE_CANCEL 10 下载状态 - 下载取消

27 method 说明 void ondownloadstart(ledownloadinfo info) void ondownloadprogress(ledownloadinfo info) void ondownloadstop(ledownloadinfo info) void ondownloadsuccess(ledownloadinfo info) void ondownloadfailed(ledownloadinfo info, String msg) void ondownloadcancel(ledownloadinfo info) void ondownloadinit(ledownloadinfo info, String msg) void ondownloadwait(ledownloadinfo info) void ongetvideoinforate(ledownloadinfo info, List rates) 开始下载 下载进度更新 下载暂停 下载完成 下载失败 取消下载 下载初始化 等待下载 获取你当前下载视频的码率 ( 比如标清 高清 原画等等 ) class DownloadCenter

28 method DownloadCenter getinstances(context context) void downloadvideo(string userkey, String uu, String vu) downloadvideo(string userkey, String uu, String vu,string ratetext) void downloadvideo(ledownloadinfo info) void allowshowmsg(boolean b) void setdownloadsavepath(string path) void setdownloadratetext(string text) List getdownloadinfolist() int getdownloadinfosize() void setmaxdownloadthread(int mmaxdownloadthread) void resumedownload(ledownloadinfo downloadinfo) void stopdownload(ledownloadinfo downloadinfo) void retrydownload(ledownloadinfo downloadinfo) void stopalldownload() void canceldownload(ledownloadinfo downloadinfo, boolean isdeletefile) LeDownloadInfo finddownloadinfo(string vu) String getdownloadfilepath(string vu) boolean isdownloadcompleted(string vu) void registerdownloadobserver(ledownloadobserver observer) void unregisterdownloadobserver(ledownloadobserver observer) 说明 单例模式, 获取 DownloadCenter 对象 下载视频 (3.0 已有的接口 ),userkey 可以为空,uu vu 必填 下载视频 (3.0 已有的接口 ), 已过期, 不建议使用这种方式 推荐使用这种方式, 参考 LedownloadInfo 下载过程是否显示 toast 提示,ture 提示,false 不提示 设置本地视频文件保存路径 设置当前视频的默认下载码率 返回所有的下载任务列表, 包括未开始 正在下载 下载完成 失败等所有的列表 获取下载任务的数量 设置同时下载的最大线程数, 建议值 1~5, 最大线程数, 默认为 3 恢复视频下载 暂停当前视频的下载 重试下载失败的视频 停止当前所有正在下载的视频 取消下载, 并且如果 isdeletefile = true, 则删除数据库中的信息, 删除本地文件 查找当前 VU 所对应的数据库中的 DownloadInfo 信息 获取当前视频保存的本地路径 查询当前视频是否下载完成 注册下载状态监听的 Observer, 可以注册多个 取消注册状态监听 Observer class LeDownloadInfo 下载过程中需要用到的方法如下 :

29 method 说明 int getdownloadstate() String getfilename() String getfilesavepath() long getprogress() long getfilelength() String getratetext() 获取当前视频的下载状态获取当前视频文件的名称获取当前视频文件保存的路径获取当前视频的下载进度获取当前视频文件的大小获取当前数据库中保存的视频所对应的码率

30 应用混淆 如果您的应用用到了混淆, 请在混淆脚本添加如下内容 :

31 -dontwarn cn.mmachina.** -keep class cn.mmachina.** { *; -dontwarn com.letv.adlib.** -keep class com.letv.adlib.** { *; -dontwarn com.lecloud.sdk.** -keep class com.lecloud.sdk.** { *; -dontwarn android.net.compatibility.** -keep class android.net.compatibility.** { *; -dontwarn android.net.http.** -keep class android.net.http.** { *; -dontwarn com.android.internal.http.multipart.** -keep class com.android.internal.http.multipart.** { *; -dontwarn org.apache.commons.** -keep class org.apache.commons.** { *; -dontwarn org.apache.http.** -keep class org.apache.http.** { *; -dontwarn com.lecloud.xutils.** -keep class com.lecloud.xutils.** { *; -dontwarn com.letv.pano.** -keep class com.letv.pano.** { *; -dontwarn android.os.** -keep class android.os.** { *; -dontwarn com.letvcloud.cmf.** -keep class com.letvcloud.cmf.** { *; -dontwarn com.lecloud.sdk.** -keep class com.lecloud.sdk.** { *; -dontwarn cn.com.iresearch.mvideotracker.** -keep class cn.com.iresearch.mvideotracker.** { *; -dontwarn com.letv.controller.tracker.** -keep class com.letv.controller.tracker.** { *; -dontwarn com.lecloud.skin.** -keep class com.lecloud.skin.** { *;

32 全景功能解析 功能说明 在 4.2 全景功能的基础上,4.3 版本又加入了 VR 功能 全景 ( 含 Vr) 功能和普通点播, 直播不同, 主要区别有 : (1) 使用 ViedeoView 不同, 需要在 UIPanoVodVideoView 类里重写方法 preparevideosurface(), 具体代码请看该类 (2) 实现接口 IPanoListener void setsurface(surface surface); /** * Click Video Area * 点击视频区域 */ void onsingletapup(motionevent e); /** * mode * {@link #PanoVideoControllerView.CONTROLL_MODE_MOTION * {@link #PanoVideoControllerView.CONTROLL_MODE_TOUCH * {@link #PanoVideoControllerView.CONTROLL_MOTION_WITH_TOUCH * {@link #PanoVideoControllerView.DISPLAY_MODE_NORMAL * {@link #PanoVideoControllerView.DISPLAY_MODE_GLASS */ //not support some mode void onnotsupport(int mode); (3) 实现 View 的 OnTouchListener 接口 public boolean ontouch(view v, MotionEvent event) { // 处理手势的事件 ((BasePanoSurfaceView) surfaceview).onpanotouch(v, event); return true;

33 (4) 重写该方法 switchcontrollmode(int mode),mode 为用户设置的值 ( 陀螺仪 PanoVideoControllerView.CONTROLL_MODE_MOTION 手势 PanoVideoControllerView.CONTROLL_MODE_TOUCH 手势 + 陀螺仪 PanoVideoControllerView.CONTROLL_MODE_MOTION_WITH_TOUCH ) protected int switchcontrollmode(int mode) { controllmode = ((BasePanoSurfaceView) surfaceview).switchcontrollmode(mode); return controllmode; (5) 重写该方法 switchdisplaymode(int mode),mode 为用户设置的值 ( 普通全 景 PanoVideoControllerView.DISPLAY_MODE_NORMAL 双目 VR PanoVideoControllerView.DISPLAY_MODE_GLASS ) protected int switchdisplaymode(int mode) { displaymode = ((BasePanoSurfaceView) surfaceview).switchdisplaymode(mode); return displaymode;

34 水印功能使用 说明 : 登录乐视云官网, 点播和直播设置水印方式参考下图 (1) 点播水印设置说明 : 给点播视频添加自定义水印, 按照下面图 (1)(2) 操作即可 ; 在播放 SDKdemo 点播界面, 需要传 PU 值,PU 值就是播放器 ID 图 (1) 图 (2) (2) 直播水印设置 说明 : 给直播视频添加自定义水印, 按照下面图 (3) 操作, 点击保存即可 ;

35 图 (3)

36 状态篇 interface IVideoView 方法后面标志 Vod, 代表该方法点播可用 ; 方法后面标志 Live, 代表该方法直播可用 ;

37 int getvideowidth() int getvideoheight() void onstart() void onresume() void onpause() void ondestroy() method void stopandrelease() void setvideoviewlistener(videoviewlistener listener) void onconfigurationchanged(configuration newconfig) void setdatasource(string playurl) boolean isplaying() void seekto(long msec) long getcurrentposition() long getduration() void setvolume(float leftvolume, float rightvolume) boolean retry() void setcachewatermark(int hight,int low) void setcachepresize(int pre) void setcachemaxsize(int max) void setmaxdelaytime(int max) seektimeshift(long date) void settimeshiftlistener(itimeshiftlistener listener) void resetplayer() 说明 获取视频宽 ( 像素 )(Vod,Live) 获取视频高 ( 像素 )(Vod,Live) 开始播放 ( 需要在播放器准备完成时调用 )(Vod,Live) 继续播放 ( 需要在在 Activity 生命周期 onresume 调用 )(Vod,Live) 暂停播放 ( 需要在在 Activity 生命周期 onpause 调用 ) (Vod,Live) 停止播放并销毁播放器 ( 需要在在 Activity 生命周期 ondestroy 调用 )(Vod,Live) 停止播放并释放播放器资源 (Vod,Live) 设置播放器状态回调参考 VideoViewListener (Vod,Live) 处理屏幕方向改变 ( 需要在 Activity 生命周期 onconfigurationchanged 调用 )(Vod,Live) 设置播放地址 Url( 把视频地址直接传到播放器 ) (Vod,Live) 视频正在播放 (Vod,Live) seek 到某个位置播放 (Vod) 获取当前播放位置 (Vod) 获取视频总时长 (Vod) 设置左右声道 (Vod,Live) 重新播放 ( 按 Home 键后回来继续播放 )(Vod,Live) 设置高低水位 (Live) 设置起播缓冲值 (Live) 设置最大缓冲值 (Live) 设置最大延时 (Live) 直播时移 (Live) 直播时移监听主要用于更新直播时间和进度条显示 (live) 重置播放器状态, 用于直接切换下一首 (vod) interface VideoViewListener

38 method void onstateresult(int event,bundle bundle) String ongetvideoratelist(linkedhashmap<string,string> map) 说明 播放器状态回调可以处理的事件参考 PlayerEvent 云点播 云直播选择码率的回调方法 PlayerEvent 属性值说明 int PLAY_INIT 200 播放器初始化 int PLAY_BUFFERING 201 获取视频二级进度条缓冲值 bundle.getint(playerparams.key_play_buffer int PLAY_COMPLETION 202 播放结束 int PLAY_DECODER_CHANGED 203 解码方式改变 ( 软解和硬解 ) int PLAY_ERROR 205 播放器错误 int PLAY_INFO 206 bundle 获取播放器状态 code <br>= bundle.getint(playerparams.key.result_statu code 有三种状态, 分别是 : 缓冲开始 StatusCode.PLAY_INFO_BUFFERING_STA 缓冲结束 StatusCode.PLAY_INFO_BUFFERING_END 渲染第一帧完成 StatusCode.PLAY_INFO_VIDEO_RENDERING_START 视频缓冲进度 ( 转圈时候的进度 StatusCode.PLAY_INFO_VIDEO_RENDERING_START int PLAY_LOADINGSTART 207 开始缓冲视频 int PLAY_PREPARED 208 播放器准备完成 int PLAY_SEEK_COMPLETE 209 seek 完成 int PLAY_VIDEOSIZE_CHANGED 210 视频宽高变化的时候触发 int VIEW_PREPARE_VIDEO_SURFACE 8001 收到该事件时, 添加视频播放器 SurfaceView int VIEW_PREPARE_AD_SURFACE 8002 收到该事件时, 添加广告播放器 SurfaceView int MEDIADATA_VOD 6000 处理媒资服务器返回点播对应的数据 int MEDIADATA_LIVE 6001 处理媒资服务器返回直播对应的数据 int MEDIADATA_GET_PLAYURL 6002 处理调度服务器返回 ( 直播 活动直播 ) 对应的数据 int MEDIADATA_ACTION 6003 处理媒资服务器返回活动直播对应的数据 int AD_START 7005 广告开始播放 int AD_COMPLETE 7006 广告播放结束 int AD_PROGRESS 7007 广告播放进度 int AD_ERROR 7008 广告播放错误

39 interface IMediaDataVideoView (extends IVideoView) method 说明 void setdatasource(bundle bundle) void setcustomid(string id) Bundle getreportparams() void setrate(string rate) 设置请求视频播放时需要的参数 设置 customid 获取日志反馈时候需要的参数 切换码率,rate 代表接口 VideoViewListener 里面 ongetvideoratelist(linkedhashmap<string,string> map) 返回 map 的 Key 值 IPlayer 播放器的状态, 使用 getstatus() 方法获取属性 值 说明 int PLAYER_STATUS_INIT 0 播放器初始化 int PLAYER_STATUS_PREPARED 1 播放器准备完成 int PLAYER_STATUS_PLAYING 2 正在播放 int PLAYER_STATUS_PAUSED 3 暂停播放 int PLAYER_STATUS_STOPED 4 停止播放 int PLAYER_STATUS_EOS 5 播放到末尾 int PLAYER_STATUS_ERROR 6 播放错误

40 method void setonplaystatelistener(onplaystatelistener playstatelistener) void setdisplay(surface surface) void stop() void start() void pause() int getvideowidth() int getvideoheight() boolean isplaying() void seekto(long msec) long getcurrentposition() long getduration() void reset() void setdatasource(string url) void setvolume(float leftvolume,float rightvolume) int getstatus() 说明 设置播放器事件回调参考 OnPlayStateListener 设置 Surface 停止播放 开始播放 暂停播放 获取视频宽 获取视频高 是否正在播放 播放器 seek 到某一个位置 获取播放器当前播放时间 获取视频时长 播放器状态重置 设置播放源 设置音量 获取播放器状态参考上面播放器属性值 boolean suspend() 播放挂起 ( 只支持点播 ) void regain() boolean retry() void seektolastpostion(long msec) void release() void cleardatasource() void setmaxdelaytime(int max) void setcachewatermark(int hight, int low) void setcachemaxsize(int max) void setcachepresize(int pre) void setdecoder(int mode) 恢复播放 重新播放 回到上次播放的位置, 参数单位 : 毫秒 释放播放器资源 在播放下一首之前, 清空数据 设置最大延时单位 :ms 设置高低水位值单位 :ms 设置最大缓冲值单位 :ms 设置起播缓冲值单位 :ms 设置解码方式, 模式有 : 自动 MediaPlayer.DECODER_TYPE_LEC_AUTO 软解 MediaPlayer.DECODER_TYPE_LEC_SOFT 硬解 MediaPlayer.DECODER_TYPE_SYS_HARD interface OnPlayStateListener

41 method void videostate(int event,bundle bundle) 说明 可以处理的事件参考 PlayerEvent interface IAdPlayer (extends IExPlayer) 属性值说明 int AD_PLAY_ERROR 0 广告播放错误 String AD_TIME "AdTime" 作为 Key 键保存广告播放时间 method void setonadplayerlistener(adplayerlistener adplayerlistener) void clickad() 说明 设置广告播放回调事件参考 AdPlayerListener 处理点击广告后事件, 跳转广告对应网页链接 interface AdPlayerListener method void onadplayerevent(int event, Bundle bundle) 说明 可以处理的广告事件参考 PlayerEvent interface IMediaDataPlayer (extends IAdPlayer) method void setonmediadataplayerlistener(mediadataplayerlistener mediaplayerlistener) void setdatasourcebyrate(string ratetype) void setdatasourcebymediadata(bundle mediadataparams) void setcustomid(string customid) String getlastrate() Bundle getreportparams() 说明 设置媒资回调事件参考 MediaDataPlayerListener 设置视频码率 设置请求视频所需参数 该方法主要用于统计 返回上次播放码率 ( 比如, 视频刚开始播放时候使用标清, 播放过程中切换码率为高清, 则这次播放结束后, 点击播放按钮, 播放时候就是使用高清 ) 获取上报参数 interface MediaDataPlayerListener

42 method void onmediadataplayerevent(int event, Bundle bundle) 说明 可以处理的媒资事件参考 MediaData interface IMediaDataLivePlayer (extends IMediaDataPlayer) method void seektimeshift(long date) void registertimeshiftlistener(itimeshiftlistener listener) void starttimeshift() void stoptimeshift() 说明 设置播放时移单位 :ms 注册时移回调事件参考 ItimeShiftListener 开始更新界面播放时间 停止更新界面时间显示 interface ItimeShiftListener method void onchange(long servertime, long currenttime, long begin) 说明 三个参数分别是 : 服务器时间, 当前播放时间, 直播开始时间 interface IMediaDataActionPlayer (extends IMediaDataLivePlayer) method void setdatasourcebyliveid(string liveid) void setactionstatuslistener(actionstatuslistener listener) void setonlinepeoplelistener(onlinepeoplechangelistener listener) 说明 设置直播的 liveid 设置活动状态回调参考 ActionStatusListener 设置在线人数变化回调参考 OnlinePeopleChangeListener

43 白名单 关于点播白名单 : 点播播放视频之前, 需要在乐视云官网注册您 app 应用包名, 注册类型为点播, 这样您可以根据 uu,vu 去请求相应的视频资源播放 否则, 如果没有在官网接入应用, 则请求资源时候会鉴权失败, 请求不到 uu,vu 对应的视频资源, 只能播放乐视宣传片 关于直播白名单 : 直播播放视频之前, 需要在乐视云官网注册您 app 应用包名, 注册类型为直播 否则, 如果没有在官网接入应用, 则请求资源时候会鉴权失败, 最终播放失败, 会提示您的应用不在白名单之内

44 常见问题问 : 点播, 直播如何切换码率? 按下面步骤做 答 : 调用接口 IMediaDataVideoView 里面设置码率的方法 void setrate(string rate), 注 : 接口 VideoViewListener 里面的方法 String ongetvideoratelist(linkedhashmap<string,string> map) 返回所有的码率 问 : 点播时候想获取视频下载进度值 (SeekBar 的二级进度 )? 按下面步骤做 答 : 截取播放器事件 PlayerEvent.PLAY_BUFFERING, 取 值 bundle.getint(playerparams.key_play_bufferpercent) 问 : 点播按比例播放视频? 按下面步骤做 答 :(1) 在 extends BaseVideoView 的类里面 ( 比如 UIVodVideoView) 添加这些代码 ISurfaceView surfaceview; protected void setvideoview(isurfaceview surfaceview) { this.surfaceview = surfaceview; super.setvideoview(surfaceview); public ISurfaceView getsurfaceview() { return surfaceview; (2) 在 PlayActivity 类里面处理事件地方加代码 case PlayerEvent.PLAY_VIDEOSIZE_CHANGED 如下 : if (videoview!= null && videoview instanceof UIVodVideoView) { ISurfaceView surfaceview = ((UIVodVideoView)videoView).getSurfaceView(); if (surfaceview!= null && surfaceview instanceof BaseSurfaceView) { ((BaseSurfaceView)surfaceView).setDisplayMode(BaseSurfaceView.DISPLAY_MODE_SCALE_ZOOM); int width = bundle.getint(playerparams.key_width); int height = bundle.getint(playerparams.key_height); ((BaseSurfaceView)surfaceView).onVideoSizeChanged(width, height); 问 : 点播想直接切换下一首? 按下面步骤做 答 : 在点击 下一个 按钮的响应事件里面这么做 :

45 if(videoview!= null){ videoview.resetplayer(); mbundle.putstring(playerparams.key_play_uuid, "hxn7psp8ot"); mbundle.putstring(playerparams.key_play_vuid, "49bf3407cb"); videoview.setdatasource(mbundle); 这段代码在我们 demo 的类 PlayActivity 里面有 问 : 点播 直播 移动直播, 默认是竖屏播放视频, 想直接横屏播放视频, 按下面步骤去做? 答 : 点播需要横屏播放, 则在类 UIVodVideoView 的 onresume() 修 改 letvvoduicon.setrequestedorientation(iletvvoduicon.screen_landscape, this); 直播在 类 UIActionLiveVideoView 里面进行同样的修改, 移动直播在类 UIMobileLiveVideoView 里面进行 同样的修改 问 : 点播不想使用默认码率播放时候, 如何选择码率? 答 : 在 interface VideoViewListener 提供方法 String ongetvideoratelist(linkedhashmap<string,string> map),map 里面包含所有的码率,map.entrySet().getValue() 表示标清, 高清, 超清等, 你可以根据 value 过滤, 返回对应的 key 值 map.entryset().getkey() 问 : 点播, 直播, 移动直播, 有皮肤播放的时候需要去掉重力感应? 按下面步骤修改 答 : 点播在类 UIVodVideoView 的方法 inituicon() 里面加这个代 码 letvvoduicon.setgravitysensor(false); 同理, 直播在类 UIActionLiveVideoView 里面进行同 样的修改, 移动直播在类 UIMobileLiveVideoView 里面进行同样的修改 问 : 需要自定义皮肤, 我应该如何操作? 答 : 我们提供了专门的皮肤工程 LePlayerSkin, 皮肤工程是开源的 如果你觉得 SDK 提供的皮肤不符合你的设计, 那么你可以不使用 LePlayerSkin 工程, 直接在无皮肤播放上添加自己需要的皮肤样式 问 : 觉得提供的 SDK 过于庞大, 如何能够缩小它? 答 : 通过以下缩减以下的几个步骤, 可以很快的缩小 SDK: (1) 删掉 SDK 自带的皮肤包, 使用自定义皮肤 (2) 在 libs 目录下只保留 armeabi_v7a, 删掉其他的目录 现在大多数手机都已经兼容了 armeabi_v7a (3) 使用我们播放框架的 remote 版本, 使用该版本, 直接替换 jar 包就可以, 不需要修改代码

46 问 : 第一次创建 SurfaceView 时, 出现黑屏一下的现象 该如何处理? 答 : 在 activity 的 oncreate 方法中加 入 getwindow().setformat(pixelformat.translucent) ; 需要导入包 import android.graphics.pixelformat; 在 fragment 中使用在 getwindow 前加 getactivity() 问 :SDK 中提供了点播 直播和移动直播, 有什么区别, 在什么情况下使用? 答 : 在 SDK 中, 提供了三种播放方式 : 点播 直播和移动直播 : 点播 : 和乐视云计算中的云点播的播放有关 播放点播视频, 需要传入参数 UUID ( 必 须 ) VUID ( 必须 ) PU( 设置你自定义水印时候, 必须填写, 具体值, 文档里面有介绍 ) 直播 : 直播需要的参数有 action_id ( 活动 ID) use_hls ( 默认走 rtmp 的播放 ) PU 值 ( 自定义 水印需要填写 ) 在直播中支持时移功能 移动直播 : 移动直播需要的参数 url, 这个可以是在线视频, 也可以是本地视频 问 : 我需要借助 SDK 提供的播放器播放我本地的视频, 这种情况下我应该怎么去播放它? 答 : 提供播放本地视频的接口 videoview.setdatasource(path) 在接口 IVideoView 里面 问 : 使用乐视 SDK 之后, 出现混淆打包失败的情况, 这样我应该如何处理? 答 : 如果使用乐视 SDK 混淆打包失败, 大多数情况都是对 SDK 进行了再次混淆 乐视 SDK 在提供 时就已经混淆了, 所以在第二次打包时, 我们不建议在对 SDK 进行混淆 问 : 我使用离线下载功能, 结果发现下载的视频被 360 等清理工具清理掉了 这种情况下怎么处理? 答 : 在使用离线下载功能中, 建议最好把下载的视频放到 SD 卡的一个随便目录下, 不要放 在 "android/data/packname/" 目录下 如果放在这个目录下,360 清理工具会检测到这是程序 运行的垃圾, 每次都会自动清理掉 如果视频被自动清理掉,SDK 会在播放时抛给用户这个事 件, 用户如果需要重新下载必须清理掉数据库中的数据 问 : 播放视频过程中, 发现有的视频音视频不同步, 这种现象怎么排查?

47 答 : 这种情况一般在电视等特别低的 CPU 中出现过, 一般排查步骤有 : 1. 看看视频源, 是不是视频源本身就是音视频不同步 2. 通过浏览器或者 IOS 或者其他手机测试一下, 看看是不是所有的都是这种现象 3. 是不是 CPU 性能太差, 建议使用硬解测试 问 : 使用离线下载功能, 同时添加了很多视频, 结果发现有些视频下载失败了怎么处理? 答 : 1. 使用离线下载功能时, 不要同时开太多的任务, 我们建议最大线程数为 1 3 个, 默认为 3 个 2. 视频能否下载, 需要检测当前视频是不是开启了下载功能 3. 当视频下载失败时, 会回调下载失败的事件, 这时就需要用户点击重试下载 问 : 视频可以跟随手机一起旋转方向, 但是我想实现那种视频单独旋转的特效要如何处理? 就像花椒直播中的横屏效果 答 : 如果想要花椒直播中类似的横屏效果 可以通过 textureview 去处理 然后调 用 setrotation(float rotation) 设置旋转方向 注意 : 旋转后需要自己计算视频宽高 问 : 起播的时候, 听到声音了, 但是过了几秒之后才看到画面 这种情况如何处理? 答 : 这种情况一般在电视等特别低的 CPU 中出现过, 一般排查步骤有 : 1. 看看视频源, 是不是有这种前几秒是先有声音的现象 2. 通过浏览器或者 IOS 或者其他手机测试一下, 看看是不是所有的都是这种现象 3. 如果在 TV 上出现, 很有可能是皮肤问题导致的, 建议使用 4.0 上无皮肤的 SDK 播放测试一 下 也可以使用硬解测试 ( 一般默认是软解方式 ) 问 :SDK 能播放点播 直播和活动直播 但是我只想要一个点播 ( 或直播 ) 应该如何处理? 答 : 在我们提供的 SDK 中, 不管是点播 直播还是活动直播, 都使用的是同一套视频的编解码 器 所以单独保留一个功能不会减少 SDK 包的大小 各个功能模块也是独立的, 所以保留其他的 模块不会相互影响 问 : 错误日志 " 鉴权失败 " 和 " 白名单验证未通过 " 答 : 对于新接入的用户或者是使用新的 APP 包名, 需要在乐视云计算官网接入 APP 在填写表单 过程中, 包名必须一致 问 : 接入播放器的时候, 出现 so 库找不到的问题

48 答 : 在有些手机中, 如果出现 so 库找不到的问题, 需要通过以下三个步骤解决 : 1. 查看当前手机支持的 CPU 型号, 一般需要支持 armeabi_v7a 2. 如果当前手机支持这中类型的编码, 那么看看工程中 libs 目录下是不是包涵其他的型号, 比如 armeabi 或者 arm64 等, 如果存在需要删掉 3. 看看是不是引用的有些 jar 包中打入了其他类型的 so 库

49 更新说明 1. 直播进度条改版 2. 增加本地日志记录和上传功能 3. 修改统计功能 4. 修复播放框架及服务端错误 5. 竖屏添加翻页功能 6. 修复播放卡顿问题 7. 修复上版遗留及新增 bug