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

Transcription

1 Table of Contents SDK 简介文档版本说明阅读对象支持系统版本整体结构图播放器 VideoView 关系图播放器 Player 关系图 SDK 名词解释播放器功能篇支持播放的格式 SDK 接入篇移动直播全景功能解析混淆规则播放器状态篇 FAQ\( 问答 \) 更新说明

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

3 文档版本说明 版本号版本说明修改者更新日期 1.5 移动直播 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 相关词语解释 移动直播 : 根据 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 = LeCl 这个 if 判断必须有, 在自己的进程初始化 cde if (getapplicationinfo().packagename.equals(processname)) { try { LeCloudPlayerConfig.LOG_LOGCAT 打印日志到控制台 LeCloudPlayerConfig.LOG_FILE 日志打印到文件 LeCloudPlayerConfig.LOG_NONE 不打印日志 LeCloudPlayerConfig.LOG_ALL 日志打印到控制台和文件 LeCloudPlayerConfig.setLogOutputType(LeCloudPlayerConfig.LOG_LOGCAT); LeCloudPlayerConfig.setHostType(host); LeCloudPlayerConfig.init(getApplicationContext()); LeCloudPlayerConfig.setmInitCmfListener( new OnInitCmfListener() public void oncdestartsuccess() { cde 启动成功, 可以开始播放如果使用 remote 版本这个方法会回调的晚一些, 因为有个下载过程只有回调了该方法, 才可以正常播放视频建议用户通过 cde 初始化的回调进行控制,

13 public void oncdestartfail() { cde 启动失败, 不能正常播放 ; 如果使用 remote 版本则可能是 remote 下载失败 public void oncmfcoreinitsuccess() { // 不包含 cde 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 = if (runningapps!= null) { for (RunningAppProcessInfo procinfo : runningapps) { if (procinfo.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 移动直播 1 添加播放器 移动直播播放器分为有皮肤 ( UIMobileLiveVideoView ) 无皮肤 ( MobileLiveVideoView ) 类型在目标界面代码中, 新建并添加播放器 ( 请勿在布局文件中直接添加播放器 ) private IMediaDataVideoView 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); // 无皮肤播放器请初始化 MobileLiveVideoView // videoview = new MobileLiveVideoView(this); // 有皮肤播放器请初始化 UIMobileLiveVideoView videoview = new UIMobileLiveVideoView(this,uuid)); // 有皮肤开启录制功能播放器 videoview = new UIMobileLiveVideoView(this,uuid,true)); // 将播放器添加到容器中 // 在这儿, 我们使用的是 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 布局文件内容如下 :

17 <?xml version="1.0" encoding="utf-8"?> <RelativeLayout xmlns:android=" android:layout_width="match_parent" android:layout_height="203dp" > </RelativeLayout> 2 播放器参数配置 1. 通过 Url 播放视频的参数配置 // Url 是一个播放地址, 扔给播放器直接播放 boolean ispano = true;// 全景播放 String playpath = " videoview.setpanorama(ispano) videoview.setdatasource(playpath); 3 开始播放 处理播放器回调事件 VideoViewListener videoviewlistener = new VideoViewListener() public void onstateresult(int event, Bundle bundle) { handleplayerevent(event, bundle);// 处理播放器事件 ; videoview.setvideoviewlistener(videoviewlistener); handleplayerevent 的实现为 :

18 * 处理播放器本身事件, 具体事件可以参见 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 @Override protected void onresume() { super.onresume(); protected void onpause() { super.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); 说明 : 移动直播通过设置 Url 播放在线视频资源, 录制端是什么码率, 播放端只能播放对应码率的视 频, 不能动态切换 ;

20 移动直播 1.5 全景功能解析 更新说明 (1)1.5 版本全景使用了 Google VR (2)1.5 版本云点播 [uu,vu] 云直播[ 活动 Id] 是否是全景播放, 取决于后台配置 (3)1.5 版本播放 url 时候, 是否是全景播放, 还和 1.4 一样, 在界面上选择关于全景的接口介绍 interface IPanoListener * 给播放器设置 surface void setsurface(surface surface); * 点击视频区域 void onsingletapup(motionevent e); * mode * { 全景 #BasePanoSurfaceView.DISPLAY_MODE_NORMAL * {VR mode #BasePanoSurfaceView.DISPLAY_MODE_GLASS * { 手势 #BasePanoSurfaceView.CONTROLL_MODE_TOUCH * { 陀螺仪 #BasePanoSurfaceView.CONTROLL_MODE_MOTION * { 手势 + 陀螺仪 BasePanoSurfaceView.CONTROLL_MODE_MOTION_WITH_TOUCH // 手机不支持这些模式时候会回调这个方法 void onnotsupport(int mode); interface IPanoEventProcess 具体实现参考 PanoEventProcessImp

21 * 创建 surfaceview, 初始化 Mode ISurfaceView getpanovideoview(); * { 手势 #BasePanoSurfaceView.CONTROLL_MODE_TOUCH * { 陀螺仪 #BasePanoSurfaceView.CONTROLL_MODE_MOTION * { 手势 + 陀螺仪 BasePanoSurfaceView.CONTROLL_MODE_MOTION_WITH_TOUCH int switchcontrollmode(int mode); * { 全景 #BasePanoSurfaceView.DISPLAY_MODE_NORMAL * {VR mode #BasePanoSurfaceView.DISPLAY_MODE_GLASS int switchdisplaymode(int mode); 根据解码方式不同设置 format void preparesoft(int decodertype); 生命周期 onresume() void onpanoresume(); 生命周期 onpause() void onpanopause(); 生命周期 ondestroy() void onpanodestroy(); 设置关于 Player 的一些 Listener void setplayerpropertylistener(); 移动直播 1.4 全景功能解析 全景 ( 含 Vr) 功能和普通点播, 直播不同, 主要区别有 : (1) 使用 ViedeoView 不同, 需要在 UIPanoMobileVideoView 类里重写方法 preparevideosurface(), 具体代码请看该类 (2) 实现接口 IPanoListener

22 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; (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;

23 (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;

24 应用混淆 # update time 最后提供给客户的混淆规则 # LePlayerSdk----proguard-start -keep class com.lecloud.sdk.api.stats.** { *; -keep class com.lecloud.sdk.api.** { *; -keep class com.lecloud.sdk.player.** { *; -keep class com.lecloud.sdk.utils.**{ *; -keep class com.lecloud.sdk.videoview.** { *; -keep class com.lecloud.sdk.listener.** { *; -keep class com.lecloud.sdk.download.**{ *; -keep class com.lecloud.sdk.config.** { *; -keep class com.lecloud.sdk.surfaceview.** { *; -keep class com.lecloud.sdk.constant.** { *; -keep class com.lecloud.sdk.pano.** { *; # cmf-proguard-start -keep class com.letvcloud.cmf.** { *; -keep class com.lecloud.uploadservice.** { *; -keep class android.os.systemproperties -keepclassmembers class android.os.systemproperties{ public <fields>; public <methods>; # LeNetWork----proguard-start -keep class com.lecloud.sdk.http.** { *; # org.apache.http.legacy----proguard-start -keep class android.net.** { *; -keep class com.android.internal.http.multipart.** { *; -keep class org.apache.** { *; # lecloudutils----proguard-start -keep class com.lecloud.xutils.** { *; # 全景 ----proguard-start -keep class com.lecloud.vrlib.** { *; -keep class com.letv.pano.** { *; -keep class com.google.vr.** { *; -keep class com.google.vrtoolkit.cardboard.** { *; # 艾瑞统计 ----proguard-start -keep class cn.com.iresearch.mapptracker.** { *; -keep class cn.com.iresearch.vvtracker.** { *; # 广告提供 jar 包 ----proguard-start -keep public class com.letv.ads.**{ *; -keep public class com.letv.plugin.pluginloader.**{ *;

25 状态篇 从 IVideoView 层接入的用户请参考如下接口 interface IVideoView 获取视频宽度 int getvideowidth() 获取视频高度 int getvideoheight() 说明 : 想要获取视频宽 高计算 SurfaceView( 也可能是 TextureView) 大小, 事件 PlayerEvent.PLAY_VIDEOSIZE_CHANGED 回调时候就可以获取到视频宽 高 收到播放器准备完成事件 PlayerEvent.PLAY_PREPARED 调用此方法, 开始播放视频 void onstart() 继续播放 ( 需要在在 Activity 生命周期 onpause 调用 ) void onresume() 暂停播放 ( 需要在在 Activity 生命周期 onpause 调用 ) void onpause() 停止播放并销毁播放器 ( 需要在在 Activity 生命周期 ondestroy 调用 ) 和 stopandrelease() 方法做的操作一样 void ondestroy() 停止播放并释放播放器资源 void stopandrelease() 设置监听返回事件回调 ( 播放器事件 媒资事件 ) void setvideoviewlistener(videoviewlistener listener) 处理屏幕方向改变 ( 需要在 Activity 生命周期 onconfigurationchanged 调用 ) void onconfigurationchanged(configuration newconfig)

26 设置播放地址 Url( 把视频地址直接传到播放器 ) void setdatasource(string playurl) 视频正在播放 true, 反之 false boolean isplaying() 点播使用,seek 到某个位置 void seekto(long msec) 点播时候获取当前播放位置 long getcurrentposition() 点播获取视频总时长 long getduration() leftvolume,rightvolume 取值范围 在事件 PlayerEvent.PLAY_INIT 时候设置 setvolume(0,0), 视频静音 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)

27 活动直播时移 void seektimeshift(long date) 活动直播时候设置监听, 只要接收返回来自服务器时间信息, 更新直播时间和进度条显示 void settimeshiftlistener(itimeshiftlistener listener) 点播切换下一首, 调用该方法 void resetplayer() 获取视频下载速率, 单位 :B/s long getdownloadrate() 播放 url 时候需要指定是否是全景视频 void setpanorama(boolean ispano); interface VideoViewListener 点播 直播 移动直播返回事件 ( 播放器事件 媒资事件 ) void onstateresult(int event,bundle bundle) 点播 活动直播获取服务器返回的码率列表 String ongetvideoratelist(linkedhashmap<string,string> map) interface IMediaDataVideoView

28 设置请求视频播信息时候需要的参数 void setdatasource(bundle bundle); 移动直播时候将 uuid 传进来 void setcustomid(string id); 获取日志反馈时候需要的参数 Bundle getreportparams(); 切换码率, 将选择好的码率传进来 (21, 标清 ), 传递标清对应的 key void setrate(string rate); interface IVodVideoView 视频是否试看 1 试看片 0 正常片 int getneedbuy(); 视频试看时长时间 >0 代表试看 int gettrylooktime(); 设置视频是否自动播放 [true: 自动播放 ;false: 不自动播放 ] void setvideoautoplay(boolean autoplay); interface PlayerEvent 播放器 player 对象创建成功之后回调的事件 int PLAY_INIT = 200; 点播时候二级进度条缓冲回调事件, 缓冲值 =bundle.getint(playerparams.key_play_bufferpercent) int PLAY_BUFFERING = 201; 视频播放结束回调事件 int PLAY_COMPLETION = 202;

29 解码方式改变回调事件 ( 默认 lec 硬解,lec 硬解失败自动切换为 lec 软解时回调该事件 ) int PLAY_DECODER_CHANGED = 203; 播放器数据下载完成时回调 ( 使用 LecPlayer 时有效 ) int PLAY_DOWNLOAD_FINISHED = 204; 导致 205 错误的可能原因如下所示 : 打印具体错误代码 int errorcode; errorcode=bundle.getint(playerparams.key_result_status_code ); (1)errorCode=500007, 没有将 SDK 里 demo 工程下面 assets 里面的内容拷贝过去 (2)errorCode=500008, 播放在线视频时候没有网络 (3)errorCode=100,cde 初始化失败 ( 可能导致 cde 初始化失败的原因 : 在 AndroidManifest.xml 里面是否配置 cmf 服务 ; 在 Application 的 OnCreate 里面, 是否只在自己的进程进行了 cde 的初始化 ; 如果使用 remote 版本, 请确认 so 文件是否下载成功 ) (4)errorCode=500001, 视频资源未找到 ( 一般网络正常情况下报这个错, 是设置到播放器的 url 有问题 ) (5)errorCode=500002, 播放器解码错误 ( 一般是播放资源的音频或者视频编码方式不属于咱现在支持的范围之内 ) int PLAY_ERRO = 205; 视频信息回调事件 int statuscode = bundle.getint(playerparams.key_result_status_code ); (1) 视频开始缓冲 statuscode = StatusCode.PLAY_INFO_BUFFERING_START; (2) 视频结束缓冲 statuscode = StatusCode.PLAY_INFO_BUFFERING_END; (3) 视频播放第一帧 statuscode = StatusCode.PLAY_INFO_VIDEO_RENDERING_START; (4) 视频缓冲进度 ( 一级进度条 ) statuscode = StatusCode.PLAY_INFO_VIDEO_BUFFERPERCENT ; 获取缓冲进度 int buffercode = bundle.getint(playerparams.key_video_buffer ); int PLAY_INFO = 206; 视频开始加载时候的回调事件 播放器已经创建但还未 prepare, 此时可以设置音量 设置缓冲等等 int PLAY_LOADINGSTART = 207; 播放器准备完成事件, 此刻调用 start() 就可以开始播放了 int PLAY_PREPARED = 208; 播放器 seek 完成回调事件

30 int PLAY_SEEK_COMPLETE = 209; 返回视频宽高 int width = bundle.getint(playerparams.key_width); int height = bundle.getint(playerparams.key_height); int PLAY_VIDEOSIZE_CHANGED = 210; 过载保护,cde 出错时候回调 int PLAY_ERROR_CDE = 212; 点播请求媒资信息的回调事件 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 time = bundle.putint(iadplayer.ad_time, adtime); int AD_PROGRESS = 7007; 广告播放错误 int AD_ERROR = 7008;

31 准备播放正片的 surface 创建 SurfaceView 并将 surface 设置给播放器 int VIEW_PREPARE_VIDEO_SURFACE = 8001; 准备播放广告的 surface 创建 SurfaceView 并将 surface 设置给播放器 int VIEW_PREPARE_AD_SURFACE = 8002; 从 IPlayer 层接入的用户参考如下接口 interface IPlayer 获取播放器状态, 返回值如下 : IPlayer.PLAYER_STATUS_INIT 播放器初始化 IPlayer.PLAYER_STATUS_PREPARED 播放器准备完成 IPlayer.PLAYER_STATUS_PLAYING 正在播放 IPlayer.PLAYER_STATUS_PAUSED 暂停播放 IPlayer.PLAYER_STATUS_STOPED 停止播放 IPlayer.PLAYER_STATUS_EOS 播放到末尾 IPlayer.PLAYER_STATUS_ERROR 播放错误 int getstatus(); 设置播放器状态监听回调 void setonplaystatelistener(onplaystatelistener playstatelistener); 设置 surface 给播放器 void setdisplay(surface surface) 视频停止播放 void stop() 视频开始播放 void start() 视频暂停 void pause() 获取视频宽度

32 int getvideowidth() 获取视频高 int getvideoheight() 视频是否正在播放 boolean isplaying() 将视频拖动到某个位置 void seekto(long msec) 获取当前播放位置 long getcurrentposition() 获取视频总时长 long getduration() 释放播放器 void release() 重置播放器 void reset() 设置播放 url void setdatasource(string url) leftvolume,rightvolume 取值范围 在事件 PlayerEvent.PLAY_INIT 时候设置 setvolume(0,0), 视频为静音 void setvolume(float leftvolume,float rightvolume) 点播挂起播放 boolean suspend() 点播恢复播放 void regain() 重新播放 boolean retry()

33 设置最大延时单位 :ms void setmaxdelaytime(int max) 设置高低水位值单位 :ms void setcachewatermark(int hight, int low) 设置最大缓冲值单位 :ms void setcachemaxsize(int max) 设置起播缓冲值单位 :ms void setcachepresize(int pre) 在播放下一首之前, 将当前数据设置为初始化状态 void cleardatasource(); 获取下载视频码率单位 :B/s long getdownloadrate(); 设置解码方式 MediaPlayer.DECODER_TYPE_LEC_AUTO 软解 MediaPlayer.DECODER_TYPE_LEC_SOFT 硬解 void setdecoder(int mode) interface OnPlayStateListener 回调事件处理 ( 播放器回调事件 ) void videostate(int event,bundle bundle) interface IAdPlayer

34 设置广告回调监听 void setonadplayerlistener(adplayerlistener adplayerlistener) 处理点击广告后事件, 跳转广告对应网页链接 void clickad() 释放广告播放资源 void onaddestroy() interface AdPlayerListener 处理广告回调事件广告开始播放 广告播放结束 广告播放错误 广告播放进度 void onadplayerevent(int event, Bundle bundle) interface IMediaDataPlayer

35 设置媒资请求结果回调监听 void setonmediadataplayerlistener(mediadataplayerlistener mediaplayerlistener) 设置视频播放时候的码率 void setdatasourcebyrate(string ratetype) 设置请求视频信息所携带的参数 void setdatasourcebymediadata(bundle mediadataparams) 设置用户 UUID void setcustomid(string customid) 返回上次播放码率 ( 比如, 视频刚开始播放时候使用标清, 播放过程中切换码率为高清, 则这次播放结束后, 点击播放按钮, 播放时候就是使用高清 ) String getlastrate() 获取上报参数 Bundle getreportparams() interface MediaDataPlayerListener 媒资请求结果回调事件 void onmediadataplayerevent(int event, Bundle bundle) interface IMediaDataLivePlayer

36 云直播时移到某个位置单位 :ms void seektimeshift(long date) 注册时移回调事件 void registertimeshiftlistener(itimeshiftlistener listener) 开始更新界面播放时间 void starttimeshift() 停止更新界面时间显示 void stoptimeshift() interface ItimeShiftListener 三个参数分别是 : 服务器时间, 当前播放时间, 直播开始时间 void onchange(long servertime, long currenttime, long begin) interface IMediaDataActionPlayer 设置直播的 liveid 根据 liveid 请求机位信息 void setdatasourcebyliveid(string liveid) 设置活动状态回调监听 void setactionstatuslistener(actionstatuslistener listener) 设置在线人数变化回调监听 void setonlinepeoplelistener(onlinepeoplechangelistener listener)

37 常见问题 问 : 移动直播按比例播放视频? 按下面步骤做 答 :(1) 在 extends BaseVideoView 的类里面 ( 比如 UIMobileLiveVideoVie) 添加这些代码 ISurfaceView 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 UIMobileLiveVideoVie) { ISurfaceView surfaceview = ((UIMobileLiveVideoVie)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); 问 : 移动直播, 默认是竖屏播放视频, 想直接横屏播放视频, 按下面步骤去做? 答 : 移动直播需要横屏播放, 则在类 UIMobileLiveVideoView 的 onresume() 修改 `letvliveuicon.setrequestedorientation(iletvvoduicon.screen_landscape, this); 问 : 移动直播, 有皮肤播放的时候需要去掉重力感应? 按下面步骤修改 答 : 点播在类 UIMobileLiveVideoVie 的方法 inituicon() 里面加这个代码 `letvliveuicon.setgravitysensor(false); 问 : 需要自定义皮肤, 我应该如何操作?

38 答 : 我们提供了专门的皮肤工程 LePlayerSkin, 皮肤工程是开源的 如果你觉得 SDK 提供的皮肤不 符合你的设计, 那么你可以不使用 LePlayerSkin 工程, 直接在无皮肤播放上添加自己需要的皮肤样 式 问 : 觉得提供的 SDK 过于庞大, 如何能够缩小它? 答 : 通过以下缩减以下的几个步骤, 可以很快的缩小 SDK: (1) 删掉 SDK 自带的皮肤包, 使用自定义皮肤 (2) 在 libs 目录下只保留 armeabi_v7a, 删掉其他的目录 现在大多数手机都已经兼容了 armeabi_v7a (3) 使用我们播放框架的 remote 版本, 使用该版本, 直接替换 jar 包就可以, 不需要修改代码 问 : 第一次创建 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 等清理工具清理掉了 这种情况下怎么处理?

39 答 : 在使用离线下载功能中, 建议最好把下载的视频放到 SD 卡的一个随便目录下, 不要放在 "android/data/packname/" 目录下 如果放在这个目录下,360 清理工具会检测到这是程序运行的垃圾, 每次都会自动清理掉 如果视频被自动清理掉,SDK 会在播放时抛给用户这个事件, 用户如果需要重新下载必须清理掉数据库中的数据 问 : 播放视频过程中, 发现有的视频音视频不同步, 这种现象怎么排查? 答 : 这种情况一般在电视等特别低的 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 能播放点播 直播和活动直播 但是我只想要一个点播 ( 或直播 ) 应该如何处理?

40 答 : 在我们提供的 SDK 中, 不管是点播 直播还是活动直播, 都使用的是同一套视频的编解码 器 所以单独保留一个功能不会减少 SDK 包的大小 各个功能模块也是独立的, 所以保留其他的 模块不会相互影响 问 : 错误日志 " 鉴权失败 " 和 " 白名单验证未通过 " 答 : 对于新接入的用户或者是使用新的 APP 包名, 需要在乐视云计算官网接入 APP 在填写表单 过程中, 包名必须一致 问 : 接入播放器的时候, 出现 so 库找不到的问题 答 : 在有些手机中, 如果出现 so 库找不到的问题, 需要通过以下三个步骤解决 : 1. 查看当前手机支持的 CPU 型号, 一般需要支持 armeabi_v7a 2. 如果当前手机支持这中类型的编码, 那么看看工程中 libs 目录下是不是包涵其他的型号, 比如 armeabi 或者 arm64 等, 如果存在需要删掉 3. 看看是不是引用的有些 jar 包中打入了其他类型的 so 库

41 更新说明 (sdk_v1.5) (1)1.5 版本全景使用了 Google VR (2)1.5 版本播放 url 时候, 是否是全景播放, 在界面上选择确定, 和 4.5 一样 (3) 增加 https 支持 默认支持 http, 在 MApplication 里面修改 // 设置支持 http parameters.put(icdesetting.scheme_type, LeCloudPlayerConfig.SCHEME_HTTP + ""); // 设置支持 https parameters.put(icdesetting.scheme_type, LeCloudPlayerConfig.SCHEME_HTTPS + ""); 更新说明 (sdk_v1.4) 1. 替换播放框架 ( 播放器解决一些播放的兼容性问题 ) 2. 移动直播可以获取下载视频速率 在类 IVideoView 中增加接口 返回下载速率, 单位 B/s long getdownloadrate(); 3. 移动直播可以录制视频

42 增加接口 public interface IMobileLiveVideoView extends IMediaDataVideoView{ * 开始录制视频 path 录制视频保存路径 format 视频格式, 比如 mp4 * return 返回值小于 0 代表录制失败, 等于 0 代表录制成功 * int startstreamer(string savepath, String format); * 结束录制视频 * int stopstreamer(); (1) 如果你要使用录制功能 new UIMobileLiveVideoView(this, customerid, true) (2) 不需要使用录制功能 new UIMobileLiveVideoView(this, customerid, false) 或者 new UIMobileLiveVideoView(this, customerid) 4. 视频高度按比例匹配布局容器, 宽度超出范围可以左右拖拽观看, 具体代码如下 在收到播放器事件的时候做如下处理 : case PlayerEvent.PLAY_VIDEOSIZE_CHANGED: if (videoview!= null && videoview instanceof UIMobileLiveVideoView) { surfaceview = ((UIMobileLiveVideoView) videoview).getsurfaceview(); if (surfaceview!= null && surfaceview instanceof VideoDragSurfaceView) { // 这是移动直播有皮肤, 视频大小竖屏占满, 横屏超出屏幕时候可以拖动的例子 ((VideoDragSurfaceView) surfaceview).setdisplaymode(basesurfaceview.display_ int width = bundle.getint(playerparams.key_width); int height = bundle.getint(playerparams.key_height); ((VideoDragSurfaceView) surfaceview).onvideosizechanged(width, height); break; 5. 增加日志打印开关

43 默认打印日志到控制台 LeCloudPlayerConfig.LOG_LOGCAT 打印日志到控制台 LeCloudPlayerConfig.LOG_FILE 日志打印到文件 LeCloudPlayerConfig.LOG_NONE 不打印日志 LeCloudPlayerConfig.LOG_ALL 日志打印到控制台和文件 LeCloudPlayerConfig.setLogOutputType(LeCloudPlayerConfig.LOG_LOGCAT); 6. 创建播放器时候用户可以指定解码方式

44 你可以在 UIMobileLiveVideoView protected void initplayer() { // 只开启录制功能 player = new MobileLivePlayer(context, 界面上传递是否录制 Boolean 值 ); // 指定 lec 硬解播放 ( 默认是 lec 硬解 ) player = new MobileLivePlayer(context, MediaPlayer.DECODER_TYPE_LEC_AUTO); // 指定 lec 硬解播放 ( 默认是 lec 硬解 ), 且开启录制功能 player = new MobileLivePlayer(context, MediaPlayer.DECODER_TYPE_LEC_AUTO, 界面上传递是否 // 使用默认解码方式, 不开启录制功能 player = new MobileLivePlayer(context); 在移动直播类 MobileLivePlayer 里面增加三个构造方法 context decodertype 取值为 : MediaPlayer.DECODER_TYPE_LEC_AUTO(Lec 硬解, 硬解失败, 自动软解 ) MediaPlayer.DECODER_TYPE_LEC_SOFT(Lec 软解 ) MediaPlayer.DECODER_TYPE_SYS_HARD( 系统硬解 ) public MobileLivePlayer(Context context, int decodertype) { super(context, decodertype); context decodertype 取值为 : MediaPlayer.DECODER_TYPE_LEC_AUTO(Lec 硬解, 硬解失败, 自动软解 ) MediaPlayer.DECODER_TYPE_LEC_SOFT(Lec 软解 ) MediaPlayer.DECODER_TYPE_SYS_HARD( 系统硬解 recordvideo true 表示开启录制视频功能,false 则没有 public MobileLivePlayer(Context context, int decodertype, boolean recordvideo) { super(context, decodertype); setplayertype(playertypemobilelive); mcreatestreamer = context recordvideo true 表示开启录制视频功能,false 则没有 public MobileLivePlayer(Context context, boolean recordvideo) { super(context); setplayertype(playertypemobilelive); mcreatestreamer = recordvideo;