Player API

利用 Player API 与 CC视频播放器进行交互，可以改变播放器界面、实现一些增值功能。 目前仅限于Flash播放器，FlashPlayer插件版本要求为10.1及以上，播放器页面代码中须允许播放器与页面脚本通信。

接口说明

接口分为两种类型：方法、 回调；具体使用方法可参照示例。 方法，是指播放器开放的JavaScript函数，开发者可通过这些函数与播放器进行交互；回调，是指播放过程中，可触发的播放器事件。

示例

HTML代码：

<object ... id="cc_A5FEB0EA05F2100B9C33DC5901307461">
...
<param name="allowFullScreen" value="true" />
<param name="allowScriptAccess" value="always" />
<embed ... name="cc_A5FEB0EA05F2100B9C33DC5901307461" allowFullScreen="true"
allowScriptAccess="always" ... />
</object>

JavaScript代码：

<script type="text/javascript">
  var player1 = getSWF( "cc_A5FEB0EA05F2100B9C33DC5901307461" );

  function on_cc_player_init( vid, objectID ){
    var player = getSWF( objectID );
    console.info( player1 == player ); 
    player.start(); 
  }

  function getSWF( swfID ) {
    if (window.document[ swfID ]) {
      return window.document[ swfID ];
    } else if (navigator.appName.indexOf("Microsoft") == -1) {
      if (document.embeds && document.embeds[ swfID ]) {
        return document.embeds[ swfID ];
      }
    } else {
      return document.getElementById( swfID );
    }
  }
</script>

配置说明

通过配置以下各项参数，可以改变播放器的界面，开启更多的回调接口，还可以使用其他的功能，如自定义全屏、字幕功能。配置播放器的方法见示例，配置项如下所示:

示例

JavaScript代码：

<script type="text/javascript"> 

  function customFullScreen(){
    //TODO 自定义全屏
  }
  
  function onPlayPaused(){
    // 已暂停播放
  }
  
  function on_cc_player_init( vid, objectID ){
    var config = {};
    config.fullscreen_enable = 1; //启用自定义全屏
    config.fullscreen_function = "customFullScreen"; //设置自定义全屏函数的名称
    config.on_player_pause = "onPlayPaused"; //设置当暂停播放时的回调函数的名称
    
    var player = getSWF( objectID );
    player.setConfig( config );
  }
  
  function getSWF( swfID ) {
    if (window.document[ swfID ]) {
      return window.document[ swfID ];
    } else if (navigator.appName.indexOf("Microsoft") == -1) {
      if (document.embeds && document.embeds[ swfID ]) {
        return document.embeds[ swfID ];
      }
    } else {
      return document.getElementById( swfID );
    }
  }

</script>

插件介绍

插件是指基于播放器实现的可插拔的独立功能块，开发者可配置player_plugins来启用插件功能。 使用插件时，请在 player_plugins 配置项中配置插件的名称和参数，使用方法见示例。

字幕插件

字幕插件可以让播放器在播放视频的同时显示相关文字，启用时在配置中添加插件名称 Subtitle ，参数如下：

注意事项：字幕文件所在的服务器根目录需要部署一个安全策略文件( crossdomin.xml )，使播放器能够跨域访问字幕文件。
了解更多关于安全策略文件可访问如下地址：

http://help.adobe.com/zh_CN/as3/dev/WS5b3ccc516d4fbf351e63e3d118a9b90204-7c85.html#WS5b3ccc516d4fbf351e63e3d118a9b90204-7e08

示例

JavaScript代码：

<script type="text/javascript">

  function on_cc_player_init( vid, objectID ){
    var config = {};
    config.player_plugins = {
      Subtitle : {
        url : "http://yourdomain/subtitle.srt"
        , size : 20
        , color : 0xCCCCCC
        , surroundColor : 0x0000FF
        , bottom : 0.15
        , font : "微软雅黑"
        , code : "utf-8"
      }
    };

    var player = getSWF( objectID );
    player.setConfig( config );
  }

</script>

播放器错误码

移动SDK

利用SDK可以对接CC视频云服务平台，进行视频上传和播放。目前上传仅对合作方开启,如果您有使用SDK的需求，请通过CC视频后台申请API Key，审核通过后方可使用。

iOS

当前版本为2.3.1，此版本SDK支持iOS 5.0 及以上操作系统。

视频播放

DWMoviePlayerController 模块继承于 MPMoviePlayerController，提供使用 userId、videoId、API KEY初始化方法，从CC视频云获取视频播放信息。

第一步，初始化 DWMoviePlayerController

Spark 提供一个透明的 Flash 进行文件上传，地址如下:

DWMoviePlayerController *player = [[DWMoviePlayerController alloc] initWithUserId:userId
        andVideoId:videoId 
        key:apiKey];

或者：

DWMoviePlayerController *player = [[DWMoviePlayerController alloc] initWithUserId:userId key:apiKey];
player.videoId = videoId;

第二步，设置请求播放信息HTTP通信超时时间

player.timeoutSeconds = 20;

默认超时时间10秒。

第三步，设置block

DWMoviePlayerController 有以下block：

typedef void(^DWMoivePlayerGetPlayUrlsBlock)(NSDictionary *playUrls);
typedef void(^DWErrorBlock)(NSError *error);

@property (copy, nonatomic)DWMoivePlayerGetPlayUrlsBlock getPlayUrlsBlock;

/**
 *  获取视频播放信息或播放过程中发生错误或失败时，回调该block。可以在该block内更新UI，如更改视频播放状态。
 */
@property (copy, nonatomic)DWErrorBlock failBlock;

其中 getPlayUrlsBlock 获取视频播放信息

player.getPlayUrlsBlock = ^(NSDictionary *playUrls) {
    // [必须]判断 status 的状态，不为"0"说明该视频不可播放，可能正处于转码、审核等状态。
    NSNumber *status = [playUrls objectForKey:@"status"];
    if (status == nil || [status integerValue] != 0) {
        NSLog("playUrlsBlock invalid");
    }
    // 保存playUrls 或 选择某种清晰度进行播放。
};

当SDK准备好视频播放信息时，会调用该block。你可以在该block中保存播放信息或实现播放逻辑。

获取的播放信息 NSDictionary *playUrls 为UTF-8编码，内容形如：

{
   "status": 0,
   "statusinfo": "正常",
   "defaultquality": 10,
   "qualityDescription": [@"清晰", @"高清"],
   "qualities": [{
       "quality": 10,
       "desp": "清晰",
       "playurl": "http://xxx.play.bokecc.com/..."
   }, {
       "quality": 20,
       "desp": "高清",
       "playurl": "http://xxx.play.bokecc.com/..."
   }]
}

注意：CC视频的播放url具有时效性，你需要在每次播放时请求视频播放信息，以取得最新的视频播放url。

第四步，开始请求播放信息

[player startRequestPlayInfo];

播放控制

播放流程的控制和 MPMoviePlayerController 使用方法一致。这里以前文获取的播放信息做简单介绍。

将 DWMoviePlayerController 的 view 添加到你的UIViewController中

在 - (void)viewDidLoad {} 中

CGRect frame = CGRectZero;
// 设置合适的 frame
UIView *videoBackgroundView = [[UIView alloc] initWithFrame:frame];
[self.view addSubview:videoBackgroundView];

player.view.frame = videoBackgroundView.frame;
[videoBackgroundView addSubview:player.view];

开始播放

[player prepareToPlay];
[player play];

暂停播放

[player pause];

继续播放

[player play];

停止播放

[player stop];

切换清晰度

[player stop];
NSString *playUrlString = @"..."; // 从视频播放信息 playUrls 中选择一种清晰度。
player.contentURL = [NSURL URLWithString:playUrlString];
[player prepareToPlay];
[player play];

视频上传

DWUploader模块提供将本地视频文件上传至CC视频云的功能。上传视频时需提供userId、API KEY、视频标题、标签和简介。 DWUploader采用多个block与App进行交互，上传视频时你需创建一个上传实例，设置上传超时时间，设置各个block，如DWUploaderProgressBlock、DWUploaderFinishBlock等，在这些block中实现App的业务逻辑。

第一步，初始化 DWUploader

视频首次上传使用userId、API KEY、视频本地路径、视频标题、标签及简介初始化DWUploader。服务器根据这些信息为视频分配videoId、上传服务器等资源，通常把这些资源称为上传上下文。当视频上传被中断（如网络断开或用户暂停），可使用上传上文初始化DWUploader实现断点续传，若此时还未获取上传上下文，则使用首次上传初始化方式重新初始化上传。

首次上传视频初始化DWUploader

DWUploader *uploader = [[DWUploader alloc] initWithuserId:userId
        andKey:apiKey
        uploadVideoTitle:videoTitle
        videoDescription:videoDescripton
        videoTag:videoTag
        videoPath:videoPath
        notifyURL:nil];

断点续传初始化DWUploader

DWUploader *uploader = [[DWUploader alloc] initWithVideoContext:self.uploadContext];

注意：通常情况下，不可对同一视频多次使用第一种初始化方式初始化上传，这样会造成大量重复视频，增加你后期管理视频的同事的工作量，且CC视频会根据你的付费套餐对每天的上传次数有不同的限制，超过最大上传次数，当天便无法上传视频。

注意：视频标题不得为空，否则会导致上传失败。

第二步，设置上传HTTP通信超时时间

uploader.timeoutSeconds = 20;

默认超时时间为10秒。

若上传过程中产生HTTP通信超时，则会调用DWErrorBlock，可以在该block设置错误处理逻辑。

第三步，设置block

DWUploader有如下block：

typedef void (^DWUploaderFinishBlock)();
typedef void (^DWErrorBlock)(NSError *error);
typedef void (^DWUploaderVideoContextForRetryBlock)(NSDictionary *videoContext);
typedef void (^DWUploaderProgressBlock)(float progress, NSInteger totalBytesWritten, NSInteger totalBytesExpectedToWrite);

/**
 *  在该block获取上传进度，可以在block内更新UI，如更新上传进度条。
 */
@property (copy, nonatomic)DWUploaderProgressBlock progressBlock;

/**
 *  上传完成时回调该block，可以在block内更新UI，如将视频标记为上传完成。
 */
@property (copy, nonatomic)DWUploaderFinishBlock finishBlock;

/**
 *  上传失败时回调该block，可以在该block内更新UI，如将视频标记为上传失败。
 */
@property (copy, nonatomic)DWErrorBlock failBlock;

/**
 *  在该block内获取上传上下文，并保存上传上下文，用来实现断线续传。
 */
@property (copy, nonatomic)DWUploaderVideoContextForRetryBlock videoContextForRetryBlock;

/**
 *  当遇到网络问题或服务器原因时上传暂停，回调该block。
 */
@property (copy, nonatomic)DWErrorBlock pausedBlock;

第四步，开始上传

[uploader start];

视频上传控制

视频上传控制用来和UI进行交互，当用户点击开始上传、暂停、继续时，可以通过调用DWUploader的start、pause、resume方法实现对应的视频上传控制。

视频下载

DWDownloader模块提供从CC视频云下载视频的功能，下载时需提供userId、API KEY、videoId及用来保存下载视频的本地文件路径。

注意：CC视频的下载url具有时效性，你需要在每次下载时重新初始化DWDownloader，以取得正确的下载url。

流程1

第一步，初始化 DWDownloader

DWDownloader *downloader = [[DWDownloader alloc] initWithUserId:userId
    andVideoId:videoId
    key:apiKey
    destinationPath:videoPath];

第二步，设置下载HTTP通信超时时间

downloader.timeoutSeconds = 20;

默认超时时间为10秒。

下载过程中HTTP通信超时时，会调用failBlock下载失败的block。告知你下载超时。

第三步，设置block

DWDownloader有如下block：

typedef void (^DWErrorBlock)(NSError *error);
typedef void (^DWDownladerFinishBlock)();
typedef void (^DWDownloaderProgressBlock)(float progress, NSInteger totalBytesWritten, NSInteger totalBytesExpectedToWrite);

/**
 *  在该block获取下载进度，可以在block内更新UI，如更新下载进度条。
 */
@property (copy, nonatomic)DWDownloaderProgressBlock progressBlock;

/**
 *  下载完成时回调该block，可以在block内更新UI，如将视频标记为下载完成。
 */
@property (copy, nonatomic)DWDownladerFinishBlock finishBlock;

/**
 *  下载失败时回调该block，可以在该block内更新UI，如将视频标记为下载失败。
 */
@property (copy, nonatomic)DWErrorBlock failBlock;

第四步，开始下载

[downloader start];

流程2

第一步，初始化 DWDownloader

DWDownloader *downloader = [[DWDownloader alloc] initWithUserId:userId
    andVideoId:videoId
    key:apiKey];

第二步，设置下载HTTP通信超时时间

downloader.timeoutSeconds = 20;

默认超时时间为10秒。

下载过程中HTTP通信超时时，会调用failBlock下载失败的block。告知你下载超时。

第三步，设置getplayinfoblock

typedef void(^DWDownloaderGetPlayUrlsBlock)(NSDictionary *playUrls);

/**
 * @brief 获取视频下载信息。
 */
@property (copy, nonatomic)DWDownloaderGetPlayUrlsBlock getPlayinfoBlock;

通过次block获取视频下载信息，NSDictionary *playUrls的结构为：

playinfo : {
defaultdefinition = 10;
definitionDescription =     (
    "\U6e05\U6670",
    "\U9ad8\U6e05"
);
definitions =     (
            {
        definition = 10;
        desp = "\U6e05\U6670";
        playurl = "http://bm2.33.play.bokecc.com/flvs/ca/Qxc52/uCrWqgNwgC-10.mp4?t=1411637615&key=8C6363C34A41EF957134313BE5258FCA&upid=3277991411630415299";
    },
            {
        definition = 20;
        desp = "\U9ad8\U6e05";
        playurl = "http://cm22.c110.play.bokecc.com/flvs/ca/Qxc52/uCrWqgNwgC-20.mp4?t=1411637615&key=E1253F7FB242E295D6F21BADF3BD88C2&upid=3277991411630415299";
    }
);
status = 0;
statusinfo = "\U6b63\U5e38";

第四步，调用获取方法

[downloader getPlayInfo];

第五步，初始化 DWDownloader

DWDownloader *downloader = [[DWDownloader alloc] initWithUserId:userId
    andVideoId:videoId
    key:apiKey
    destinationPath:videoPath];

第六步，设置下载HTTP通信超时时间

downloader.timeoutSeconds = 20;

默认超时时间为10秒。

下载过程中HTTP通信超时时，会调用failBlock下载失败的block。告知你下载超时。

第七步，设置block

参考流程1中设置。

第八步，调用下载方法

[downloader startWithUrlString:(NSString *)urlString];

下载视频控制

视频下载控制用来和UI进行交互，当用户点击开始下载、暂停、继续时，可以通过调用DWDownloader的start、pause、resume方法实现对应的视频下载控制。

使用Demo

SDK Demo是使用SDK对接CC视频云的示例源码，Demo的设计旨在展示SDK各项功能的使用方法，如果希望应用获得更好的使用体验，可根据需求自行更改。

Demo采用代码绘制UI界面，这种方式利于精准控制，批量修改、多人协作。

准备

第一步，设置账户信息

首先将你userId和API KEY填写在Demo工程下的Demo-Prefix.pch 中:

#define DWACCOUNT_USERID @"****************"
#define DWACCOUNT_APIKEY @"********************************"

并核对，确认填写无误。userId和API KEY信息会显示在 Demo app 的首页。

第二步，设置下载使用的videoId

你需要在DWDownloadViewController.m中修改generateTestData函数：

- (void)generateTestData
{
    // 将@"..."替换成你要下载的videoId，可以添加多个。 
    self.videoIds = @[];
}

第三步，设置播放使用的videoId

你需要在DWPlayerViewController.m中修改generateTestData函数：

- (void)generateTestData
{
    // 将@"..."替换成你要播放的videoId，可以添加多个。 
    self.videoIds = @[];
}

到此Demo配置完毕，已可以使用Demo测试你的账号。

播放视频

播放器支持本地播放和网络播放，你可以使用DWCustomPlayerViewController播放CC视频云上的视频，也可以使用它播放本地文件，同时你也可以使用MPMoviePlayerController自带的播放器播放。与MPMoviePlayerController相比，DWCustomPlayerViewController提供了字幕、清晰度切换、画面尺寸调整、音量控制等功能；播放页面的UI元素全部是定制的、可修改的。

第一步，使用DWCustomPlayerViewController播放CC视频云上的视频

参见2.1.1 使用SDK播放CC视频云上视频的流程。

第二步，使用DWCustomPlayerViewController播放从CC视频云下载的视频

DWMoviePlayerController *player = [[DWMoviePlayerController alloc] init];

// 设置屏幕高宽比例为：适应屏幕大小，保持宽高比
player.scalingMode = MPMovieScalingModeAspectFit;

player.view.backgroundColor = [UIColor clearColor];

CGRect frame = CGRectZero;
// 设置合适的 frame
UIView *videoBackgroundView = [[UIView alloc] initWithFrame:frame];
[self.view addSubview:videoBackgroundView];

player.view.frame = videoBackgroundView.frame;
[videoBackgroundView addSubview:player.view];

// 设置本地播放NSURL
player.contentURL = [[NSURL alloc] initFileURLWithPath:self.videoLocalPath];

[player prepareToPlay];
[player play];
//[player pause];
//[player stop];

调试与反馈问题

SDK提供了DWLog模块用来打印HTTP通信日志，可以在App的任意位置开启或关闭 打印HTTP通信日志等功能。下面是DWLog的使用方法：

// 开启 打印HTTP通信日志 功能
[DWLog setIsDebugHttpLog:YES];

// 关闭 打印HTTP通信日志 功能
[DWLog setIsDebugHttpLog:NO];

当遇到无法播放、上传或下载时，首先要排除userId和API KEY是否有效，其次判断网络是否正常、是否已经连接。除此之外还可以通过 HTTP通信日志排查问题。

Android

当前版本为2.3.1，此版本SDK支持Android 2.3及以上操作系统。

概述

CC视频Android SDK是基于Android API实现的类库，支持Android2.3及以上版本，开发者可通过此SDK对接CC视频云服务平台，进行播放、上传和下载操作。

CC视频2.0版Android SDK包提供了以下文件：

• CCSDK.jar，是集成SDK播放、上传和下载等功能的类库；
• sdk_guide，是SDK的使用指南；
• ccsdkdemo，是使用SDK对接CC视频云服务的示例源码，支持Android4.0及以上版本；
• sdk_doc，是描述SDK内部接口信息的文档。

为确保SDK可正常使用，请按照以下操作配置项目环境：

1. 将CCSDK.jar添加到Android项目中，并配置当前项目可正确的引用此类库。

2. 配置项目的网络权限和文件读写权限：

<!-- 用于网络通信 -->
<uses-permission android:name="android.permission.INTERNET" />
<!-- 用于存储已下载文件 -->
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />

3. CCSDK.jar已经过混淆处理，如果需要对应用进行混淆编译，请在混淆的配置文件中加入以下代码，以避免SDK被二次混淆编译。

-keep public class com.bokecc.sdk.mobile.**{*;}
-keep public interface com.bokecc.sdk.mobile.**{*;}

视频播放

SDK视频播放由DWMediaPlayer类实现，DWMediaPlayer继承了Android的媒体播放器MediaPlayer类，并重载其prepare()和prepareAsync()方法。

使用DWMediaPlayer既可播放CC视频云服务平台下的视频（以下简称在线播放），也可播放本地视频。

在线播放

使用SDK的在线播放功能时，仅需设置视频ID、账户ID、API KEY及Context（上下文信息）即可播放云端视频。具体实现方式如下：

String videoId ="123456"; 
Context context = getApplicationContext();
DWMediaPlayer player = new DWMediaPlayer();

// 设置视频播放信息
player.setVideoPlayInfo(videoId, "USERID", "API_KEY", context);
player.prepareAsync();

当播放器准备播放完成后，调用start()方法开始播放视频。同时，DWMediaPlayer提供了getVideoStatusInfo（获取视频状态），getVideoTitle（获取视频标题）等方法，开发者可根据需要在应用中展示相应的信息。

选择清晰度播放

DWMediaPlayer提供了getDefinitions()方法获取当前播放的视频清晰度列表。如果需要切换视频的清晰度，可根据当前视频的清晰度对DWMediaPlayer进行设置。具体实现方式如下，

// 获取清晰度列表
Map<String, Integer> definitions = player.getDefinitions();
// 获取某种清晰度对应的状态码
int definitionCode = definitions.get("definitionInfo");
// 设置播放清晰度
player.setDefinition(context, definitionCode);

本地播放

在使用DWMediaPlayer播放本地视频时，与使用Android默认媒体播放器MediaPlayer播放本地视频的方法相同，仅需设置视频文件地址。具体实现方式如下，

String path = "/123456.MP4";
DWMediaPlayer player = new DWMediaPlayer();

//设置视频文件地址
player.setDataSource(path);
player.prepare();

当播放器准备完成后，调用start()方法即可开始播放视频。

错误处理

DWMediaPlayer重载了MediaPlayer的setOnErrorListener()方法，如果需要在应用中提示错误信息，可调用此方法设置OnErrorListener。具体实现方式如下，

private OnErrorListener onErrorListener = new OnErrorListener() {
    @Override
    public boolean onError(MediaPlayer mp, int what, int extra) {
        
        //TODO 处理错误信息
        
        return false;
    }
};

player.setOnErrorListener(onErrorListener);

视频上传

SDK视频上传由Uploader类实现，Uploader通过HTTP协议与服务端进行通信，上传视频信息和视频文件。同时，SDK提供了上传回调接口UploadListener来监听视频上传流程，如果需要在应用中展示上传状态、上传进度等信息，可根据需要进行设置。

Uploader使用示例

使用Uploader上传前，请先了解Uploader的工作流程：

• 1. 创建Uploader实例，初始化视频信息，此时Uploader进入等待状态（WAIT）。
• 2. 当需要开始上传时，调用start()方法开始上传，此时Uploader进入上传状态（UPLOAD）。
• 3. 当需要暂停上传时，调用pause()方法。另外，在上传过程中可能出现网络异常问题，当出现此问题时，Uploader默认会暂停当前上传操作，进入暂停状态（PAUSE）。
• 4. 当需要恢复上传时，调用resume()方法，若无网络异常等问题，此时Uploader会重新上传视频文件。
• 5. 当需要取消上作时，调用cancel()方法，此时Uploader会进入等待状态（WAIT）。

创建Uploader实例需提供VideoInfo（视频信息）和 API KEY，使用示例如下：

VideoInfo videoInfo = new VideoInfo();
videoInfo.setTitle("title");
videoInfo.setTags("tag");
videoInfo.setDescription("description"); 
 
// 设置视频文件地址
videoInfo.setFilePath("filePath");
// 设置账号信息
videoInfo.setUserId("USERID"
// 设置回调信息
videoInfo.setNotifyUrl(“NOTIFY_URL");

Uploader uploader = new Uploader(videoInfo,"API_KEY");

// 开始上传
uploader.start();

VideoInfo是用来记录上传过程与视频相关的信息，具体介绍请参考sdk_doc，在初始化视频信息时，服务端需根据视频的标题、标签、描述等来创建视频，所以在使用VideoInfo创建Uploader实例时，请确保视频信息非空。

设置上传回调

Uploader在执行上传操作时，默认会检查是否设置了UploadListener。若已设置UploadListener，Uploader会回调UploadListener已实现的方法；若未设置，则不回调任何信息。UploadListener具体使用方法如下：

UploadListener uploadListener = new UploadListener(){

    @Override
    public void handleProcess(long range, long size, String videoId) {
        // TODO 处理上传进度
    }

    @Override
    public void handleException(DreamwinException exception, int status) {
        // TODO 处理上传过程中出现的异常
    }

    @Override
    public void handleStatus(VideoInfo videoInfo, int status) {
        // TODO 处理上传回调的视频信息及上传状态    
    }

    @Override
    public void handleCancel(String videoId) {
        // TODO 处理取消上传的后续操作    
    }
};

uploader.setUploadListener(uploadListenner);

视频下载

SDK视频下载由Downloader类实现的，Downloader通过HTTP协议与服务端进行通信，获取视频下载地址。同时，SDK提供了下载回调接口DownloadListener来监听视频下载流程，如果需要向用户展示下载状态、下载进度等信息，可根据需要进行设置。

Downloader使用示例

在使用Downloader前，请先了解Downloader的工作流程：

• 1. 创建Downloader实例，初始化视频文件下载信息，此时Downloader进入等待状态（WAIT）。
• 2. 当需要开始下载时，调用start()方法，此时Downloader进入下载状态（DOWNLOAD）。
• 3. 当需要暂停下载时，调用pause()方法。另外，在下载过程中可能出现网络异常问题，当出现此问题时，Downloader默认会暂停下载操作，进入暂停状态（PAUSE）。
• 4. 当需要恢复下载时，调用resume()方法。若无网络异常等问题，此时Downloader会重新下载视频文件。
• 5. 当需要取消视频下载时，调用cancel()方法，此时Downloader会进入等待状态（WAIT）。

创建Downloader实例需提供视频存储文件，视频ID，账户ID和API KEY。示例如下：

File file = new File("/123456.MP4");
String videoId ="123456";
Downloader downloader = new Downloader(file, videoId,"USERID","API_KEY");

// 开始下载
downloader.start();

SDK视频下载需指定文件存储路径，所以在创建Downloader实例时，请提供正确的文件存储路径。

设置下载回调

Downloader在执行下载操作时，默认会检查是否设置了DownloadListener。若已设置DownloadListener，Downloader会回调DownloadListener接口已实现的方法；若未设置，则不回调任何信息。DownloadListener使用方法如下：

DownloadListener downloadListener = new DownloadListener(){
    @Override
    public void handleProcess(long start, long end, String videoId) {
        // TODO 处理下载进度
    }

    @Override
    public void handleException(DreamwinException exception, int status) {
        // TODO 处理下载过程中发生的异常信息        
    }

    @Override
    public void handleStatus(String videoId, int status) {
        // TODO 处理视频下载信息及相应状态
    }

    @Override
    public void handleCancel(String videoId) {
        // TODO 处理取消下载的后续操作
    }
};

downloader.setDownloadListener(downloadListener);

选择清晰度下载

流程如下：

• 1. 创建Downloader实例；
• 2. 调用setOnProcessDefinitionListener()方式设置清晰度回调；
• 3. 调用getDefinitionMap()方法获取清晰度；
• 4. 根据获取的清晰度，调用setDownloadDefinition()方法设置想要的清晰度；
• 5. 调用start()下载指定清晰度。

获取清晰度时需实现OnProcessDefinitionListener接口的onProcessDefinition()方法，并调用Downloader的setOnProcessDefinitionListener()方法设置获取清晰度回调，获取清晰度的示例如下：

class DownloadDemo{
    private HashMap<Integer, String> dm;
    private Downlaoder downloader;

    private OnProcessDefinitionListener onProcessDefinitionListener = new OnProcessDefinitionListener(){
        @Override
        public void onProcessDefinition(HashMap<Integer, String> definitionMap) {
            if(definitionMap != null){
                dm = definitionMap;
            } else {
                Log.e("get definition error", "视频清晰度获取失败");
            }
        }

        @Override
        public void onProcessException(DreamwinException exception) {
            Log.i("get definition exception", exception.getErrorCode().Value());
        }

    };
    
    private getDefinition(){
        downloader.setOnProcessDefinitionListener(onProcessDefinitionListener);
        downloader.getDefinitionMap();
    }
    ……

}

使用Demo

SDK Demo是使用SDK对接CC视频云服务的示例源码，目前支持Android4.0及以上版本。Demo的设计旨在展示SDK各项功能的使用方法，如果希望应用获得更好的使用体验，可根据需求自行更改。

准备

在编译安装Demo前，请按照以下操作进行配置：

1. 设置帐户信息，在ConfigUtil类中配置USERID（帐户ID）和API KEY。

public final static String API_KEY = "API KEY";
public final static String USERID = "123456";

2. 添加播放列表，在PlayFragment类中配置playVideoIds（可播放的视频ID）。

//TODO 待播放视频ID列表，可根据需求自定义
private String[] playVideoIds = new String[] {
    "123456",
    "234567",
    "345678", 
    "111111"};

添加下载列表，在DownloadFragment类中配置downloadVideoIds（可下载的视频ID）。

//TODO 待下载视频ID，可根据需求自定义
private String[] downloadVideoIds = new String[] {
    "123456",
    "234567",
    "345678", 
    "111111"};

功能模块简介

Demo包含播放、上传和下载三个功能模块：

• 播放模块，展示了在线播放，屏幕缩放，清晰度切换，字幕等功能，具体实现请参考PlayFragment及MediaPlayActivity类。
• 上传模块，展示了视频上传的处理流程，及如何使用SDK进行后台上传，具体实现请参考UploadFragment及UploadService类。
• 下载模块，展示了视频下载的处理流程，及如何使用SDK进行后台下载，具体实现请参考DownloadFragment及DownloadService类。

调试与反馈问题

辅助调试工具

SDK提供HTTP通信日志调试功能。在使用SDK进行播放、上传、下载过程中，如果遇到与网络通信相关的问题，可通过设置HTTP日志的级别获取通信信息。使用示例如下：

// 设置HTTP通信日志级别
HttpUtil.LOG_LEVEL = HttpLogLevel.DETAIL;

默认日志级别为GENERAL（记录HTTP通信发⽣生时间、响应状态码）。

FAQ

Q：无法播放视频

1. 检查已配置的帐户是否开通移动端播放权限      
2. 根据HTTP通信日志，排查网络问题
3. 检查视频状态是否正常

Q：上传视频出现异常

1. 检查已配置的帐户是否开通了客户端上传权限
2. 根据HTTP通信日志，排查网络问题

Q：下载视频出现异常

1. 检查已配置的帐户是否开通了移动端权限
2. 根据HTTP通信日志，排查网络问题
3. 检查视频状态是否正常

文档下载

Spark API开发文档

Player API开发文档