点播场景

import { TXVodPlayer, TXVodConstants, TXVodDef, ITXVodPlayCallback } from 'liteavsdk';

// 创建播放器实例
this.player = new TXVodPlayer(getContext());

@Entry
@Component
struct VodPlayerView {
    private xComponentController: XComponentController = new XComponentController();
    private surfaceId: string = '';
    @State surfaceSize: { width: number, height: number } = { width: 0, height: 0 };

    build() {
        Column() {
            XComponent({
                id: 'vodPlayer',
                type: XComponentType.SURFACE,
                controller: this.xComponentController,
                libraryname: 'liteavsdk'
            })
            .width('100%')
            .height(200)
            .onLoad(() => {
                // XComponent 加载完成，可以设置渲染目标
                this.surfaceId = this.xComponentController.getXComponentSurfaceId();
                // 设置用于视频渲染的目标
                this.player?.setVideoRenderTarget(this.surfaceId);
            })
        }
        .width('100%')
    }
}

// 设置播放器回调
this.player.setVodPlayCallback({
    onPlayEvent: (vodPlayer: TXVodPlayer, event: number, eventData?: Map<string, TXVodDef.ParamType>): void => {
        switch (event) {
            case TXVodConstants.VOD_PLAY_EVT_PLAY_BEGIN:
                // 视频播放开始
                break;
            case TXVodConstants.VOD_PLAY_EVT_PLAY_PROGRESS:
                // 播放进度更新
                let currentPositionMs = eventData?.get(TXVodConstants.EVT_PLAY_PROGRESS_MS) as number;
                let durationMs = eventData?.get(TXVodConstants.EVT_PLAY_DURATION_MS) as number;
                break;
            case TXVodConstants.VOD_PLAY_EVT_PLAY_END:
                // 视频播放结束
                break;
            case TXVodConstants.VOD_PLAY_EVT_CHANGE_RESOLUTION:
                // 视频分辨率改变
                let videoWidth = eventData?.get(TXVodConstants.EVT_PARAM1) as number;
                let videoHeight = eventData?.get(TXVodConstants.EVT_PARAM2) as number;
                break;
        }
    },
    onNetStatus: (player: TXVodPlayer, statusData: Map<string, TXVodDef.ParamType>): void => {
        // 网络状态更新
        let width = statusData.get(TXVodConstants.NET_STATUS_VIDEO_WIDTH) as number;
        let height = statusData.get(TXVodConstants.NET_STATUS_VIDEO_HEIGHT) as number;
    }
});

// 停止播放
this.player.stopPlay(true);

// 设置1.2倍速播放
this.player.setRate(1.2); 

// 设置循环播放
this.player.setLoop(true);
// 获取当前循环播放状态
let isLoop = this.player.isLoop(); 

// 设置静音，true 表示开启静音， false 表示关闭静音
this.player.setMute(true);

// 设置音量大小，范围：0 ~ 100
this.player.setAudioPlayoutVolume(80);

this.player.setAutoPlay(false);  // 设置为非自动播放
this.player.startVodPlay(playInfoParams);    // startVodPlay 后会加载视频，加载成功后不会自动播放
// ......
// 在播放器界面上展示广告
// ......  
this.player.resume();  // 广告展示完调用 resume 开始播放视频

import { TXVodPlayConfig } from 'liteavsdk';

let config: TXVodPlayConfig = new TXVodPlayConfig();
let headers: Map<string, string> = new Map();
headers.set('Referer', 'Referer Content');
config.headers = headers;
this.player.setConfig(config);

// 在收到播放器 VOD_PLAY_EVT_PLAY_BEGIN 事件后调用 getSupportedBitrates 才会有值返回
let bitrateItems: TXVodDef.TXBitrateItem[] = this.player.getSupportedBitrates(); // 获取多码率数组
let index = bitrateItems[i].index;  // 指定要播的码率下标
this.player.setBitrateIndex(index);  // 切换码率到想要的清晰度

this.player.setBitrateIndex(TXVodConstants.INDEX_AUTO); // index 参数传入 -1（INDEX_AUTO）

let config: TXVodPlayConfig = new TXVodPlayConfig();
// 设为 true，可平滑切换码率, 设为 false 时，可提高多码率地址打开速度
config.smoothSwitchBitrate = true;
this.player.setConfig(config);

this.player.setVodPlayCallback({
    onPlayEvent: (vodPlayer: TXVodPlayer, event: number, eventData?: Map<string, TXVodDef.ParamType>): void => {
        if (event == TXVodConstants.VOD_PLAY_EVT_PLAY_PROGRESS) {
            // 可播放时长，即加载进度, 单位是毫秒
            let playableDuration = eventData?.get(TXVodConstants.EVT_PLAYABLE_DURATION_MS) as number;
            // 播放进度, 单位是毫秒
            let progress = eventData?.get(TXVodConstants.EVT_PLAY_PROGRESS_MS) as number;
            // 视频总长, 单位是毫秒
            let duration = eventData?.get(TXVodConstants.EVT_PLAY_DURATION_MS) as number;
        }
    },
    onNetStatus: (player: TXVodPlayer, statusData: Map<string, TXVodDef.ParamType>): void => {}
});

this.player.setVodPlayCallback({
    onPlayEvent: (vodPlayer: TXVodPlayer, event: number, eventData?: Map<string, TXVodDef.ParamType>): void => {},
    onNetStatus: (player: TXVodPlayer, statusData: Map<string, TXVodDef.ParamType>): void => {
        let netSpeed = statusData.get(TXVodConstants.NET_STATUS_NET_SPEED) as number;
    }
});

this.player.setVodPlayCallback({
    onPlayEvent: (vodPlayer: TXVodPlayer, event: number, eventData?: Map<string, TXVodDef.ParamType>): void => {
        if (event == TXVodConstants.VOD_PLAY_EVT_VOD_PLAY_PREPARED) {
            // 获取视频宽高
            let width = vodPlayer.getWidth();
            let height = vodPlayer.getHeight();
        }
    },
    onNetStatus: (player: TXVodPlayer, statusData: Map<string, TXVodDef.ParamType>): void => {
        let width = statusData.get(TXVodConstants.NET_STATUS_VIDEO_WIDTH) as number;
        let height = statusData.get(TXVodConstants.NET_STATUS_VIDEO_HEIGHT) as number;
    }
});

let config: TXVodPlayConfig = new TXVodPlayConfig();
config.maxBufferSize = 10;  // 播放时最大缓冲大小。单位：MB
this.player.setConfig(config);

// 添加外挂字幕，传入字幕 url、字幕名称、字幕类型，建议在启动播放器前添加
this.player.addSubtitleSource(
    'https://example.com/subtitle.vtt', 
    'subtitleName', 
    TXVodConstants.VOD_PLAY_MIMETYPE_TEXT_VTT
);

// 开始播放视频后，选中添加的外挂字幕，在收到 VOD_PLAY_EVT_VOD_PLAY_PREPARED 事件后调用
this.player.setVodPlayCallback({
    onPlayEvent: (vodPlayer: TXVodPlayer, event: number, eventData?: Map<string, TXVodDef.ParamType>): void => {
        if (event == TXVodConstants.VOD_PLAY_EVT_VOD_PLAY_PREPARED) {
            let trackInfoList: TXVodDef.TXTrackInfo[] = vodPlayer.getSubtitleTrackInfo();
            for (let tempInfo of trackInfoList) {
                if (tempInfo.name == 'subtitleName') {
                    // 选中字幕
                    vodPlayer.selectTrack(tempInfo.trackIndex);
                } else {
                    // 其它字幕不需要的话，进行 deselectTrack
                    vodPlayer.deselectTrack(tempInfo.trackIndex);
                }
            }
        }
        if (event == TXVodConstants.VOD_PLAY_EVT_SELECT_TRACK_SUCCESS) {
            // 轨道切换成功
            let trackIndex = eventData?.get(TXVodConstants.EVT_KEY_SELECT_TRACK_INDEX) as number;
        }
    },
    onNetStatus: (player: TXVodPlayer, statusData: Map<string, TXVodDef.ParamType>): void => {}
});

// 监听字幕数据回调
this.player.setVodPlayCallback({
    onPlayEvent: (vodPlayer: TXVodPlayer, event: number, eventData?: Map<string, TXVodDef.ParamType>): void => {},
    onNetStatus: (player: TXVodPlayer, statusData: Map<string, TXVodDef.ParamType>): void => {},
    onSubtitleData: (player: TXVodPlayer, subtitleData: TXVodDef.TXVodSubtitleData): void => {
        // 字幕文本内容，可用于显示
        let subtitleText = subtitleData.subtitleText;
    }
});

// 返回音频轨道信息列表
let trackInfoList: TXVodDef.TXTrackInfo[] = this.player.getAudioTrackInfo();
for (let tempInfo of trackInfoList) {
    if (tempInfo.trackIndex == 0) {
        // 通过判断 trackIndex 或者 name 切换到需要的音轨
        this.player.selectTrack(tempInfo.trackIndex);
    } else {
        // 不需要的音轨进行 deselectTrack
        this.player.deselectTrack(tempInfo.trackIndex);
    }
}

// 功能使用流程：
// 1、定义待渲染的 image 变量
@State snapshotImage: image.PixelMap | null = null;

// 2、设置截图回调
this.player.setVodPlayCallback({
    onPlayEvent: (vodPlayer: TXVodPlayer, event: number, eventData?: Map<string, TXVodDef.ParamType>): void => {},
    onNetStatus: (player: TXVodPlayer, statusData: Map<string, TXVodDef.ParamType>): void => {},
    onSnapshotComplete: (player: TXVodPlayer, pixelMap?: image.PixelMap): void => {
        // 截图结果回调
        this.snapshotImage = pixelMap;
    }
});

// 3、调用截图方法
// snapshotAsync 方法需传入 UIContext 和 XComponent 的 id
this.player.snapshotAsync(this.getUIContext(), this.nativeXComponentID);

// 4、渲染截图结果
if (this.snapshotImage) {
    Image(this.snapshotImage)
        .width(`${this.surfaceSize.width}px`)
        .height(`${this.surfaceSize.height}px`);
}

// 播放视频 A: 如果将 autoPlay 设置为 true，那么 startVodPlay 调用会立刻开始视频的加载和播放
let urlA = 'http://1252463788.vod2.example.com/xxxxx/v.f10.mp4';
this.playerA.setAutoPlay(true);
this.playerA.startVodPlay(TXVodDef.TXPlayInfoParams.createWithUrl(urlA));

// 在播放视频 A 的同时，预加载视频 B，做法是将 setAutoPlay 设置为 false
let urlB = 'http://1252463788.vod2.example.com/xxxxx/v.f20.mp4';
this.playerB.setAutoPlay(false);
this.playerB.startVodPlay(TXVodDef.TXPlayInfoParams.createWithUrl(urlB)); // 不会立刻开始播放，而只会开始加载视频

this.playerA.setVodPlayCallback({
    onPlayEvent: (vodPlayer: TXVodPlayer, event: number, eventData?: Map<string, TXVodDef.ParamType>): void => {
        // 在视频 A 播放结束的时候，直接启动视频 B 的播放，可以做到无缝切换
        if (event == TXVodConstants.VOD_PLAY_EVT_PLAY_END) {
            this.playerA.stopPlay(true);
            this.playerB.resume();
        }
    },
    onNetStatus: (player: TXVodPlayer, statusData: Map<string, TXVodDef.ParamType>): void => {}
});

let config: TXVodPlayConfig = new TXVodPlayConfig();
config.maxPreloadSize = 2;  // 预播放最大缓冲大小。单位：MB, 根据业务情况设置去节省流量
this.player.setConfig(config);

let config: TXVodPlayConfig = new TXVodPlayConfig();
config.maxBufferSize = 10; // 播放时最大缓冲大小。单位：MB
this.player.setConfig(config);

import { TXVodPreloadManager, ITXVodPreloadCallback } from 'liteavsdk';

// 设置播放引擎的全局缓存目录和缓存大小
TXVodGlobalSetting.setCacheFolderPath(getContext().filesDir);
TXVodGlobalSetting.setMaxCacheSize(200);

// 获取预下载管理器实例
let preloadManager = TXVodPreloadManager.getInstance(getContext());

let playUrl = 'http://****';
let preloadSizeMB = 3;  // 预下载大小，单位 MB
let preferredResolution = 720 * 1280;  // 期望分辨率

// 启动预下载
let taskId = preloadManager.startPreloadUrl(playUrl, preloadSizeMB, preferredResolution, null, {
    onComplete: (taskId: number, url: string) => {
        console.log('preload complete! taskId:' + taskId + ' url: ' + url);
    },
    onError: (taskId: number, url: string, code: number, msg: string): void => {
        console.log('preload error! taskId: ' + taskId + ' url: ' + url + ' errorcode: ' + code + ' errmsg: ' + msg);
    }
});

// 取消预下载
preloadManager.stopPreload(taskId);