Skip to content

GitLab

  • Menu
Projects Groups Snippets
    • Loading...
  • Help
    • Help
    • Support
    • Community forum
    • Submit feedback
    • Contribute to GitLab
  • Sign in
  • V VOD_Android_SDK
  • Project information
    • Project information
    • Activity
    • Labels
    • Members
  • Repository
    • Repository
    • Files
    • Commits
    • Branches
    • Tags
    • Contributors
    • Graph
    • Compare
  • Issues 6
    • Issues 6
    • List
    • Boards
    • Service Desk
    • Milestones
  • Merge requests 0
    • Merge requests 0
  • CI/CD
    • CI/CD
    • Pipelines
    • Jobs
    • Schedules
  • Deployments
    • Deployments
    • Environments
    • Releases
  • Monitor
    • Monitor
    • Incidents
  • Packages & Registries
    • Packages & Registries
    • Infrastructure Registry
  • Analytics
    • Analytics
    • CI/CD
    • Repository
    • Value stream
  • Wiki
    • Wiki
  • Snippets
    • Snippets
  • Activity
  • Graph
  • Create a new issue
  • Jobs
  • Commits
  • Issue Boards
Collapse sidebar
  • CCVideo
  • VOD_Android_SDK
  • Wiki
  • 8.升级指南

Last edited by zzw Oct 17, 2022
Page history

8.升级指南

8.1 从2.x.x升级到SDK3.x.x版本需要注意的地方

旧版本获得错误信息使用的是DreamwinException类,获取错误码的方法是e.getErrorCode().Value()。

//旧版本SDK获得错误信息的方式        
player.setOnDreamWinErrorListener(new OnDreamWinErrorListener() {
    @Override
    public void onPlayError(DreamwinException e) {
        //获得错误码
        int errorCode = e.getErrorCode().Value();
    }
});        

SDK3.0.0获得错误信息使用的是HuodeException类,获取错误码的方法是e.getIntErrorCode(),新的错误码分类更加详细,错误码的具体意义请查看“4.功能使用--错误码”章节。

//SDK3.x.x获得错误信息的方式
player.setOnDreamWinErrorListener(new OnDreamWinErrorListener() {
    @Override
    public void onPlayError(HuodeException e) {
        //获得错误码
        int errorCode = e.getIntErrorCode();
    }
});

8.2 升级到SDK3.5.1及以上版本需要注意的地方

3.5.1及以上版本授权验证接口新增加一个跑马灯信息的字段。

//获得授权验证信息
player.setOnAuthMsgListener(new OnAuthMsgListener() {
    /**
     * @param enable   视频是否可以完整播放 0:不允许完整播放 1:允许完整播放
     * @param freetime 视频试看时间,单位:秒
     * @param messaage 不允许播放,或者试看结束时播放器显示的提示内容
     * @param marqueeInfo 跑马灯信息,具体使用方法请参考4.18章节
     */
    @Override
    public void onAuthMsg(int enable, int freetime, String messaage, MarqueeInfo marqueeInfo) {
        
    }
});

3.5.1以下版本。

//获得授权验证信息
player.setOnAuthMsgListener(new OnAuthMsgListener() {
    /**
     * @param enable   视频是否可以完整播放 0:不允许完整播放 1:允许完整播放
     * @param freetime 视频试看时间,单位:秒
     * @param messaage 不允许播放,或者试看结束时播放器显示的提示内容
     */
    @Override
    public void onAuthMsg(int enable, int freetime, String messaage) {
        
    }
});

8.3 升级到SDK3.7.1及以上版本需要注意的地方

在Project的build.gradle文件中增加maven地址maven {url 'http://nexus-app.bokecc.com/repository/sdk-group/'},配置如下。

allprojects {
    repositories {
        google()
        jcenter()
        //以下两个必须配置
        maven {url 'https://dl.bintray.com/bokecc/maven'}
        maven {url 'http://nexus-app.bokecc.com/repository/sdk-group/'}
        //使用投屏功能时添加此配置,不使用不需要
        maven { url 'http://4thline.org/m2'}
    }
}

在App的build.gradle的文件中增加依赖implementation 'com.bokecc:commonLib:0.1.9'。

implementation 'com.bokecc:commonLib:0.1.9'

将implementation 'com.bokecc:http:1.2.0'和implementation 'com.bokecc:drmv6:2.19.0'替换为implementation 'com.bokecc:drm:1.2.0'。

implementation 'com.bokecc:drm:1.2.0'

混淆规则增加以下配置。

-keep class com.tencent.mars.** {
  public protected private *;
}

8.4 JCenter停止服务引起的依赖问题

在Project的build.gradle文件中JCenter的仓库将不在使用

//废弃
<!--maven { url 'https://dl.bintray.com/bokecc/maven' }  -->
//请使用如下maven地址
 maven { url 'http://nexus-app.bokecc.com/repository/sdk-group/' }

在module层的build.gradle文件中,依赖命名有所更改,更改如下:

//点播SDK依赖,3.8.0版本之后
implementation 'com.bokecc:CCVOD:3.xx.x'
//投屏功能相关依赖
implementation 'com.bokecc:ProjectionLib:1.7.0'
//使用Vr播放功能时需要引入
implementation 'com.bokecc:VrPlayLib:1.0.0'
//上传视频时使用压缩功能时需要引用
implementation 'com.bokecc:CompressVideoLib:1.0.0'

8.5 初始化相关

自3.16.1版本起,需要在Application实例类的onCreate()方法中进行SDK的相关初始化,若未正常调用,会抛出响应的RuntimeException。

 InitializeManager.getInstance(getContext()).initialize();

8.6 离线日志

自3.18.4版本起,需要在在播放器播放前设置下clientid (setClientId),当用户出现问题时提供下userid以及设置的clientId既能快速查询到该用户的日志

 public void setClientId(String clientId){}

如果不希望上传日志,不进行设置clientId即可

Clone repository

1.概述
2.开发准备
3.快速集成
4.功能使用
5.使用说明
6.问题集锦 7.更新日志
8.升级指南
9.错误码
合规指南 README