短视频 SDK Android（手势操作）

一、相关接口类

二、挂件编辑过程

当手势点击某个挂件时，TAVWidgetContentView 会调用 ITAVWidgetEditViewFactory 中的方法去创建挂件编辑视图，目前内置的基础编辑视图有两种：

·贴纸基础编辑视图：TAVStickerEditView

·画中画基础编辑视图：TAVPipEditView

挂件边框和操作按钮的绘制都在相应的 EditView 进行绘制，可以通过继承相应的 EditView 对不同挂件绘制不同的编辑框。

三、主要接口介绍

四、主要方法介绍

五、设置自定义的贴纸编辑视图

1. 先自行实现贴纸编辑视图。

public class MyStickerEditView extends TAVStickerEditView { public MyStickerEditView(Context context, TAVSticker sticker) { super(context, sticker); // 自己的逻辑 // 如果需要获取挂件在View中的顶点位置，可以使用 getVertexPoints 方法获得 } }

2. 然后为 TAVWidgetContentView 设置挂件编辑视图工厂：

public class MyWidgetContentView extends TAVWidgetContentView { public MyWidgetContentView(Context context) { super(context); setEditViewFactory(new ITAVWidgetEditViewFactory() { @Override public TAVStickerEditView createStickerEditView(TAVSticker sticker) { return new MyStickerEditView(context, sticker); } @Override public TAVPipEditView createPipEditView(TAVPip pip) { // 不需要自定义画中画编辑视图时，返回 SDK 默认实现 return new TAVPipEditView(context, pip); } }); } }

3. 在 TAVEditor initWithPreview 的时候传入自定义的 TAVWidgetContentView：

// 通过 TAVMagicFactory 创建编辑器实例 TAVEditor editor = TAVMagicFactory.createEditor(); TAVEditorConstants.PreviewParam param = new TAVEditorConstants.PreviewParam(); param.videoView = findViewById(R.id.preview_container); // FrameLayout，承载预览画面 // 传入自定义的TAVWidgetContentView param.contentView = new MyWidgetContentView(context); param.loopPlay = true; param.autoPlay = true; editor.initWithPreview(param);

六、监听挂件手势事件

public class MyWidgetContentView extends TAVWidgetContentView { public MyWidgetContentView(Context context) { super(context); // 添加挂件事件监听 addWidgetEventListener(new ITAVWidgetEventListener() { @Override public void onWidgetClick(TAVWidget widget, MotionEvent event) { // 挂件被点击 } @Override public void onWidgetTouchBegin(TAVWidget widget, MotionEvent event) { // 挂件开始拖动 } @Override public void onWidgetTouchEnd(TAVWidget widget, MotionEvent event) { // 挂件拖动结束 } @Override public void onWidgetAdjust(TAVWidget widget, TAVWidgetOperationMode operationMode) { // 挂件正在拖动 } @Override public void onWidgetActive(TAVWidget widget) { // 挂件被激活编辑 } @Override public void onWidgetResign(TAVWidget widget) { // 挂件被取消激活 } }); }}

七、挂件手势层可配置项

TAVWidgetContentView 的公开配置能力，可在自定义子类的构造函数中调用。

挂件类型常量（位掩码）

手势事件常量（位掩码）

配置方法

状态查询与激活

可重写钩子（子类覆盖）

挂件状态与移动限制枚举

public class MyWidgetContentView extends TAVWidgetContentView { public MyWidgetContentView(Context context) { super(context); // 只让贴纸响应拖动与点击 setWidgetType(WIDGET_TYPE_STICKER); setEventType(EVENT_TYPE_DRAG | EVENT_TYPE_CLICK); // 移动时限制顶点，避免拖出画面 setMoveLimit(TAVWidgetMoveLimit.LIMIT_VERTEX); } @Override protected PointF positionInterceptor(float x, float y) { // 返回拦截处理后的坐标 return super.positionInterceptor(x, y); }}

八、高级操作

需要重写 TAVWidgetContentView 相关方法。

九、自定义 TAVWidgetContentView 展示逻辑

@Override protected boolean shouldShowEditView() { // 增加自己的展示判断逻辑 return super.shouldShowEditView(); } @Override protected void updateWidgetEditViewVisibility() { if (null != currentEditView && null != currentWidget) { final boolean shouldShow = shouldShowEditView(); // 根据展示条件修改TAVWidgetEditView可见性 } }

十、操作拦截

TAVWidgetContentView 提供了下列接口实现对挂件的拦截：

示例代码展示了通过重写 positionInterceptor 方法来实现移动时的位置吸附效果：

@Override protected PointF positionInterceptor(float x, float y) { PointF translation = new PointF(x, y); PointF[] previewPoints = currentEditView.computeVertexPoints(translation); float previewCenterX = (previewPoints[0].x + previewPoints[2].x) / 2f; float previewCenterY = (previewPoints[0].y + previewPoints[2].y) / 2f; float viewCenterX = getWidth() / 2f; float viewCenterY = getHeight() / 2f; float deltaX = viewCenterX – previewCenterX; float deltaY = viewCenterY – previewCenterY; // 小于10像素吸附 if (Math.abs(deltaX) <= 10) { translation.x += deltaX; } if (Math.abs(deltaY) <= 10) { translation.y += deltaY; } return translation; }