You need to enable JavaScript to run this app.
导航
高级功能
最近更新时间:2023.07.25 19:24:45首次发布时间:2021.04.14 14:20:55

快速开始中,我们完成播放器实例创建。本文档介绍如何使用 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