高级功能

在快速开始中，我们完成播放器实例创建。本文档介绍如何使用 Android 播放器完成复杂的播放功能，仅适用于高级版 SDK。

预加载

预加载相关接入说明请参考预加载接入。

纯音频播放

点播 SDK 播放视频时，具有只解码音频不解码视频的功能，适用于纯音频播放场景；相比您根据自身业务逻辑场景实现的纯音频播放，SDK 只解码音频会更省电。

// 纯音频播放
ttVideoEngine.setRadioMode(true);
// 恢复音视频播放
ttVideoEngine.setRadioMode(false);

播放下载网速

1. 在初始化 TTSDK 前设置，全局打开实时下载速度监听。

   // 全局打开实时下载速度监听，在初始化 TTSDK 前调用 
   TTVideoEngine.setIntValue(DATALOADER_KEY_INT_NEED_SPEED_TEST_BY_TIMEINTERNAL, 1);
   
   // 初始化 TTSDK
   Env.init(...)；
   

2. 设置单个实例测速时间间隔。

   // value 为测速时间间隔，单位 MS 推荐值 500 MS
   // 调用时机：设置播放源后调用
   ttVideoEngine.setCustomHeader("X-SpeedTest-TimeInternal", value);
   

3. 设置回调监听。

   // 设置回调监听
   TTVideoEngine.setDataLoaderListener(new DataLoaderListener());
   
   interface DataLoaderListener {
       ...
       /**
        * 
        * @param what == DATALOADER_KEY_NOTIFY_SPEEDINFO 时为网速回调
        * 此时，code 为 netReadLen（单位 Byte），parameter 为 netReadTime（单位 ms）
        */
       public void  onNotify(int  what, long  code, long  parameter, String info) {
           if  (what == DataLoaderHelper.DATALOADER_KEY_NOTIFY_SPEEDINFO) {
               float  dataSize = code / 1024;
               float  time = parameter / 1000;
               float  speed = dataSize / time; // 单位 KB/s
               Log.d(TAG, "download speed = "  + speed);
           }
       }
   }
   

故障排除

使用高级功能需要同时满足 2 个条件。

• 使用高级版 SDK；
• 购买高级版 License。详情操作请参见管理应用。

您在接入高级功能时，如果功能未生效，请检查控制台 Log，判断是 SDK 版本问题还是 License 问题。例如，

• SDK 版本不支持：checkAuth failed feature audio_only, SDK edition standard_edition
• License 不支持：checkAuth failed feature audio_only, license check result