功能概览
通过画中画相关接口可以实现在短视频编辑里面插入画中画(PIP),本文介绍了画中画功能相关接口类和方法,包括 TAVEditor、ITAVPipManager、TAVPip 的使用示例,涵盖创建、加载和移除画中画操作。
相关接口类
接口类名 | 描述 |
TAVEditor | SDK 操作入口类。 |
ITAVPipManager | 画中画操作接口类。 |
TAVPip | 画中画数据模型类。 |
相关方法
获取画中画操作接口
/*** 获取画中画操作接口** @return ITAVPipManager实例*/ITAVPipManager pipManager = editor.getPipManager();
创建画中画对象
/*** 创建画中画对象** @param type 资源类型(VIDEO / PHOTO)* @param mediaPath 画中画视频/图片路径*/TAVPip pip = pipManager.createPip(TAVMediaType.VIDEO, mediaPath);// 设置时间区间(微秒)pip.setTimeRange(TAVTimeRange.fromUs(0, durationUs));
加载画中画
/*** 加载画中画** @param pip 画中画数据对象*/pipManager.loadPip(pip);
移除画中画
/*** 移除画中画** @param pip 要移除的画中画对象*/pipManager.removePip(pip);
监听画中画列表变化
ITAVPipContextObserver 用于监听画中画集合的变化。回调 | 参数 | 说明 |
onPipListChanged(List<TAVPip> pips) | 当前全部画中画。 | 集合整体变化时回调,携带最新列表。 |
onPipAdd(TAVPip pip) | 新增的画中画。 | 新增一个画中画时回调。 |
onPipRemove(TAVPip pip) | 被移除的画中画。 | 移除一个画中画时回调。 |
观察者以弱引用持有,业务方必须自己保留强引用(例如作为成员变量),否则对象被回收后回调不再触发。
// 声明为成员变量,避免被 GCprivate final ITAVPipContextObserver mPipObserver = new ITAVPipContextObserver() {@Overridepublic void onPipListChanged(List<TAVPip> pips) {// 列表整体变化}@Overridepublic void onPipAdd(TAVPip pip) {// 新增画中画}@Overridepublic void onPipRemove(TAVPip pip) {// 移除画中画}};
// 注册与注销pipManager.addPipObserver(mPipObserver);pipManager.removePipObserver(mPipObserver);
说明:
TAVWidgetContentView 已内置实现该接口,使用自定义挂件手势层时通常无需重复注册。使用示例
// 获取画中画操作接口ITAVPipManager pipManager = editor.getPipManager();// 创建画中画对象(TAVPip 构造函数为 protected,须通过管理接口创建)TAVPip pip = pipManager.createPip(TAVMediaType.VIDEO, context.getFilesDir() + "/video.mp4");pip.setTimeRange(TAVTimeRange.fromUs(0, 5_000_000)); // 0-5秒// 加载画中画pipManager.loadPip(pip);// 移除画中画pipManager.removePip(pip);