升级至4.5.0

升级路径

本文以3.4.10版本为例介绍升级至4.5.0版本的操作步骤。Android播放器SDK4.5.0版本及后续的版本SDK仅类名和方法有变化，版本号有区别。4.5.0升级至5.1.4版本接口变化详情请参见升级Android播放器至5.1.0。低于4.5.0版本直接升级至5.1.4版本暂无参考文档，如有需要请提交工单，获取阿里云技术支持。

升级步骤-本地依赖

如果您采用了本地依赖方式集成Android播放器SDK，升级至4.5.0版本需要替换本地依赖包及gradle依赖包。替换完成后按指引修改代码完成升级。

1. 替换本地依赖包及gradle依赖包。

   1. 替换本地依赖包。

      将AlivcPlayer-3.4.10.aar、AlivcReporter-1.2.aar、AliyunVodPlayer-3.4.10.aar替换为AliyunPlayer-4.5.0-full.aar。替换完成：

   2. 增加阿里云的Maven地址。

      在项目的build.gradle文件中，在buildscript和allprojects两处增加阿里Maven地址，示例如下：

      maven { url "http://maven.aliyun.com/nexus/content/repositories/releases" }

   3. 替换gradle依赖包。

      将OSS的依赖删除，增加conan的依赖。修改后如下：

2. 集成短视频。

   如果集成Android播放器SDK的同时也集成短视频SDK，那么播放器的SDK需要依赖两个包：AliyunPlayer-4.5.0-part和com.aliyun.video.android:AlivcFFmpeg:1.0.0（这个包是为了使用与短视频SDK共通的ffmpeg版本）。

   说明

   如果集成时使用了错误的SDK包，会导致ffmpeg冲突。

3. 修改代码。

   依赖包替换完成之后，编译工程就会出错。这个时候，需要使用播放器4.5.0版本SDK中的类和方法。此处变化比较大，主要是包名的变化与API的变化。下面是几个需要重点修改的地方：

   1. 更改创建播放器方式
      播放器4.5.0版本SDK创建播放器对象类型改为AliPlayer，通过AliPlayerFactory类进行创建。示例如下：

      //定义一个播放器对象
      AliPlayer mAliyunVodPlayer;
      ...
      //创建播放器对象
      mAliyunVodPlayer = AliPlayerFactory.createAliPlayer(getContext().getApplicationContext());

   2. 修改监听事件
      播放器3.4.10版本SDK，监听事件都是位于IAliyunVodPlayer类下面。播放器4.5.0版本SDK，所有的监听事件都是在IPlayer类下面。类名基本保持一致，有些有变化。所以替换监听事件需要替换类名。详细变化情况请参见监听事件变化。此处以OnPreparedListener为例：修改类名后：
4. 设置播放源。
   播放器3.4.10版本SDK通过prepareAsync方法直接传值。播放器4.5.0版本SDK改为AliPlayer.setDataSource方法设置。设置完之后，调用AliPlayer.prepare方法准备播放源。示例如下：

   /**
    * 设置UrlSource数据源
    */
   public void setDataSource(UrlSource urlSource);
   /**
    * 设置vidSts数据源
    */
   public void setDataSource(VidSts vidSts);
   /**
    * 设置vidAuth数据源
    */
   public void setDataSource(VidAuth vidAuth);
   /**
    * 设置mps数据源
    */
   public void setDataSource(VidMps vidMps);

   设置直播时移：通过AliLiveShiftPlayer.setDataSource方法设置时移源。示例如下：

   /**
    * 设置数据源
    */
   public void setDataSource(LiveShift liveShift);    

   说明 如果由AlivcMediaPlayer升级到新版本播放，改用UrlSource播放即可。

升级步骤-gradle依赖

如果您采用了gradle依赖方式集成Android播放器SDK，升级至4.5.0版本需要删除本地依赖并替换gradle依赖包。

1. 删除本地依赖并替换gradle依赖包。

   1. 删除本地依赖。

      删除AlivcPlayer-3.4.10.aar、AlivcReporter-1.2.aar、AliyunVodPlayer-3.4.10.aar依赖包（删除框中的内容）。

   2. 增加阿里云的Maven地址。

      在项目的build.gradle文件中，在buildscript和allprojects两处增加阿里云的Maven地址：

      maven { url "http://maven.aliyun.com/nexus/content/repositories/releases" }

   3. 替换gradle依赖包。

      修改App的build.gradle文件，dependencies节点中增加对aar的引用。示例如下：

      implementation 'com.aliyun.sdk.android:AliyunPlayer:4.5.0-full'
      implementation 'com.alivc.conan:AlivcConan:0.9.5'

2. 集成短视频。

   如果集成Android播放器SDK的同时也集成短视频SDK，那么播放器的SDK需要依赖两个包：AliyunPlayer-4.5.0-part和com.aliyun.video.android:AlivcFFmpeg:1.0.0（这个包是为了使用与短视频SDK共通的ffmpeg版本）。

   说明

   如果集成时使用了错误的SDK包，会导致ffmpeg冲突。

3. 修改代码。

   依赖包替换完成之后，编译工程就会出错。这个时候，需要使用播放器4.5.0版本SDK中的类和方法。此处变化比较大，主要是包名的变化与API的变化。下面是几个需要重点修改的地方：

   1. 更改创建播放器方式
      播放器4.5.0版本SDK创建播放器对象类型改为AliPlayer，通过AliPlayerFactory类进行创建。示例如下：

      //定义一个播放器对象
      AliPlayer mAliyunVodPlayer;
      ...
      //创建播放器对象
      mAliyunVodPlayer = AliPlayerFactory.createAliPlayer(getContext().getApplicationContext());

   2. 修改监听事件
      播放器3.4.10版本SDK，监听事件都是位于IAliyunVodPlayer类下面。播放器4.5.0版本SDK，所有的监听事件都是在IPlayer类下面。类名基本保持一致，有些有变化。所以替换监听事件需要替换类名。详细变化情况请参见监听事件变化。此处以OnPreparedListener为例：修改类名后：
4. 设置播放源。
   播放器3.4.10版本SDK通过prepareAsync方法直接传值。播放器4.5.0版本SDK改为AliPlayer.setDataSource方法设置。设置完之后，调用AliPlayer.prepare方法准备播放源。示例如下：

   /**
    * 设置UrlSource数据源
    */
   public void setDataSource(UrlSource urlSource);
   /**
    * 设置vidSts数据源
    */
   public void setDataSource(VidSts vidSts);
   /**
    * 设置vidAuth数据源
    */
   public void setDataSource(VidAuth vidAuth);
   /**
    * 设置mps数据源
    */
   public void setDataSource(VidMps vidMps);

   设置直播时移：通过AliLiveShiftPlayer.setDataSource方法设置时移源。示例如下：

   /**
    * 设置数据源
    */
   public void setDataSource(LiveShift liveShift);    

   说明 如果由AlivcMediaPlayer升级到新版本播放，改用UrlSource播放即可。

播放器变化

依赖包变化

混淆配置变化

  -keep class com.alivc.**{*;}
  -keep class com.aliyun.**{*;}
  -keep class com.cicada.**{*;}
  -dontwarn com.alivc.**
  -dontwarn com.aliyun.**

类名与方法变化

Android播放器SDK4.5.0版本，修改了部分类名，增加了新的功能和事件回调。同时，也移除了低于SDK4.5.0版本中的部分接口。

监听事件变化

public interface OnRenderingStartListener {
     void onRenderingStart();
}
public void setOnRenderingStartListener(OnRenderingStartListener l);

public interface OnStateChangedListener {
    void onStateChanged(int newState);
}
public void setOnStateChangedListener(OnStateChangedListener l);

/**
 * 未知状态
 */
public static final int unknow = -1;
 /**
 * 空状态。刚创建出来的状态。
 */
public static final int idle = 0;
/**
 * 初始化了的状态，设置播放源之后的状态
 */
public static final int initalized = 1;//
/**
 * 准备成功的状态
 */
public static final int prepared = 2;
/**
 * 正在播放的状态
 */
public static final int started = 3;
/**
 * 播放已暂停的状态
 */
public static final int paused = 4;
/**
 * 播放已停止的状态
 */
public static final int stopped = 5;
/**
 * 播放完成状态
 */
public static final int completion = 6;
/**
 * 出错状态
 */
public static final int error = 7;

public interface OnInfoListener {
    void onInfo(InfoBean infoBean);
}
public void setOnInfoListener(OnInfoListener l);

public interface OnLoadingStatusListener {
    void onLoadingBegin();
    void onLoadingProgress(int percent, float netSpeed);  //百分比，kbps
    void onLoadingEnd();
}
public void setOnLoadingStatusListener(OnLoadingStatusListener l);

public interface OnInfoListener {
     void onInfo(InfoBean infoBean);
}
public void setOnInfoListener(OnInfoListener l);

public interface OnErrorListener {
    void onError(ErrorInfo errorInfo);
}
public void setOnErrorListener(OnErrorListener l);

public interface OnInfoListener {
    void onInfo(InfoBean infoBean);
}
public void setOnInfoListener(OnInfoListener l);

/**
 * 未知。
 */
Unknown(-1);
/**
 * 循环播放开始。无额外信息。
 */
LoopingStart(0),
/**
 * 缓冲位置。额外值为当前缓冲位置。单位：毫秒。
 */
BufferedPosition(1),
/**
 * 当前播放位置。额外值为当前播放位置。单位：毫秒。
 */
CurrentPosition(2),
/**
 * 开始自动播放。无额外信息。
 */
AutoPlayStart(3),
/**
 * 设置了硬解，但是切换为软解。额外信息为描述信息。
 */
SwitchToSoftwareVideoDecoder(100),
/**
 * 音频解码格式不支持。额外信息为描述信息。
 */
AudioCodecNotSupport(101),
/**
 * 音频解码器设备失败。额外信息为描述信息。
 */
AudioDecoderDeviceError(102),
/**
 * 视频解码格式不支持。额外信息为描述信息。
 */
VideoCodecNotSupport(103),
/**
 * 视频解码器设备失败。额外信息为描述信息。
 */
VideoDecoderDeviceError(104),
/**
 * 网络失败，需要重试。无额外信息。
 */
NetworkRetry(107),
/**
 * 缓存成功。无额外信息。
 */
CacheSuccess(108),
/**
 * 缓存失败。额外信息为描述信息。
 */
CacheError(109),
/**
 * 系统无可用内存来存放媒体数据
 */
LowMemory(110),

public interface OnTrackChangedListener {
    void onChangedSuccess(TrackInfo trackInfo);
    void onChangedFail(TrackInfo trackInfo, ErrorInfo errorInfo);
}
public void setOnTrackChangedListener(OnTrackChangedListener l);

public interface OnTrackChangedListener {
    void onChangedSuccess(TrackInfo trackInfo);
    void onChangedFail(TrackInfo trackInfo, ErrorInfo errorInfo);
}
public void setOnTrackChangedListener(OnTrackChangedListener l);

public interface OnErrorListener {
  void onError(ErrorInfo info);
}
void setOnErrorListener(IPlayer.OnErrorListener l)

主要API变化

低于4.5.0版本相关文档

如您需要查看低于4.5.0版本接口的相关内容，请参见Android播放器SDK。找到您所需版本的更新记录，单击历史版本中的示例代码下载链接即可获取对应信息。