移动开发音视频【免费下载链接】CameraView A well documented, high-level Android interface that makes capturing pictures and videos easy, addressing all of the common issues and needs. Real-time filters, gestures, watermarks, frame processing, RAW, output of any size.项目地址https://gitcode.com/gh_mirrors/ca/CameraView点击查看免费下载CameraView 库允许在预览界面内直接监听五类手指手势捏合、轻点、长按、水平/垂直滚动并通过mapGesture()方法将它们映射到具体的相机操作上——捏合缩放、点按对焦、滑动调节曝光等。本文以 gestures 官方文档 为主线结合 gesture 包源码 与 CameraView.java 的实现讲清手势映射的完整规则表、XML 属性用法以及手势检测、取值计算与事件分发三个层次的源码原理帮助你在自己的相机应用中快速定制“所见即所控”的交互体验。为什么需要手势映射移动相机 App 的交互惯例早已固定双指捏合变焦、单指轻点对焦、长按拍照。CameraView 没有把这些行为写死而是设计了一套“手势 → 动作”的可配置映射机制CameraView在其边界内监听多种手势开发者用mapGesture()将手势绑定到特定动作。这样既能复刻典型行为也能按产品需求重新分配例如把捏合用于调节曝光把轻点用于拍照cameraView.mapGesture(Gesture.PINCH, GestureAction.ZOOM); // Pinch to zoom! cameraView.mapGesture(Gesture.TAP, GestureAction.AUTO_FOCUS); // Tap to focus! cameraView.mapGesture(Gesture.LONG_TAP, GestureAction.TAKE_PICTURE); // Long tap to shoot!有两点需要注意并非所有映射都合法。例如不能把变焦绑到长按上也不能用捏合触发对焦。合法组合由枚举的类型约束决定详见下文映射矩阵部分动作可能不受传感器支持。例如某设备不支持曝光补偿时EXPOSURE_CORRECTION无法生效应通过CameraOptions确认设备能力源码见 CameraOptions.supports(GestureAction)它对ZOOM调用isZoomSupported()、对AUTO_FOCUS调用isAutoFocusSupported()等。手势映射规则矩阵从手势侧看每种手势能绑定哪些动作手势说明可映射的动作PINCH捏合手势通常用于缩放控制ZOOMEXPOSURE_CORRECTIONFILTER_CONTROL_1FILTER_CONTROL_2NONETAP单击手势通常用于对焦控制AUTO_FOCUSTAKE_PICTURETAKE_PICTURE_SNAPSHOTNONELONG_TAP长按手势AUTO_FOCUSTAKE_PICTURETAKE_PICTURE_SNAPSHOTNONESCROLL_HORIZONTAL水平滑动手势ZOOMEXPOSURE_CORRECTIONFILTER_CONTROL_1FILTER_CONTROL_2NONESCROLL_VERTICAL垂直滑动手势ZOOMEXPOSURE_CORRECTIONFILTER_CONTROL_1FILTER_CONTROL_2NONE从动作侧看每个动作能被哪些手势触发手势动作说明可绑定到手势NONE禁用该手势TAPLONG_TAPPINCHSCROLL_HORIZONTALSCROLL_VERTICALAUTO_FOCUS在手指位置启动触摸测光操作TAPLONG_TAPTAKE_PICTURE通过 takePicture 拍照TAPLONG_TAPTAKE_PICTURE_SNAPSHOT通过 takePictureSnapshot 截取预览帧TAPLONG_TAPZOOM变焦PINCHSCROLL_HORIZONTALSCROLL_VERTICALEXPOSURE_CORRECTION调节曝光补偿PINCHSCROLL_HORIZONTALSCROLL_VERTICALFILTER_CONTROL_1控制实时滤镜的第一个参数若滤镜接受该参数PINCHSCROLL_HORIZONTALSCROLL_VERTICALFILTER_CONTROL_2控制实时滤镜的第二个参数若滤镜接受该参数PINCHSCROLL_HORIZONTALSCROLL_VERTICAL合法性约束的源码实现ONE_SHOT 与 CONTINUOUS“不是每个映射都合法”这条规则在源码中由 GestureType 保证。手势和动作都被标记为两种类型之一ONE_SHOT单次操作型一次触发即完成如TAP/LONG_TAP手势AUTO_FOCUS、TAKE_PICTURE等动作CONTINUOUS连续操作型随手指持续变化如PINCH和两个SCROLL_*手势ZOOM、EXPOSURE_CORRECTION、滤镜参数动作。判定逻辑只有两行位于 Gesture.isAssignableTo()public boolean isAssignableTo(NonNull GestureAction action) { return action GestureAction.NONE || action.type() type; }即任何手势都可以映射为NONE用于禁用其余动作要求手势与动作类型一致。所以TAPONE_SHOT无法映射到ZOOMCONTINUOUSPINCH也无法映射到TAKE_PICTURE。另外注意一个默认值细节GestureAction 中五种手势的默认动作全部是NONE即CameraView初始状态下所有手势都是关闭的必须显式mapGesture才会生效。XML 属性配置方式同样的映射也可以在布局 XML 中声明。属性定义见 attrs.xmlcom.otaliastudios.cameraview.CameraView app:cameraGesturePinchzoom|exposureCorrection|filterControl1|filterControl2|none app:cameraGestureTapautoFocus|takePicture|takePictureSnapshot|none app:cameraGestureLongTapautoFocus|takePicture|takePictureSnapshot|none app:cameraGestureScrollHorizontalzoom|exposureCorrection|filterControl1|filterControl2|none app:cameraGestureScrollVerticalzoom|exposureCorrection|filterControl1|filterControl2|none/每个属性都是enum格式可选值与上表的动作一一对应小驼峰命名非法组合在 XML 层面即不成立。例如com.otaliastudios.cameraview.CameraView android:layout_widthmatch_parent android:layout_heightmatch_parent app:cameraGesturePinchzoom app:cameraGestureTapautoFocus/XML 属性如何进入手势映射表属性解析由 GestureParser 完成它在构造时从TypedArray读取五个枚举值缺省回退到GestureAction.DEFAULT_*均为NONE再通过 GestureAction.fromValue() 按整数值还原为枚举。CameraView在应用 XML 时把解析结果逐一喂给mapGesture()CameraView.java#L298-L302因此 XML 与 Java API 走的是完全相同的映射与校验逻辑。手势检测层三个 GestureFinderCameraView内部维护三个手势探测器实例CameraView.java#L245-L247探测器覆盖的手势底层 Android 组件PinchGestureFinderPINCHScaleGestureDetectorTapGestureFinderTAP、LONG_TAPGestureDetectorScrollGestureFinderSCROLL_HORIZONTAL、SCROLL_VERTICALGestureDetector三者均继承自抽象基类 GestureFinder统一提供“激活开关 触点记录 连续值计算”的能力激活开关mapGesture()每次映射成功后会按手势类型重新计算对应 finder 的激活状态——例如 PINCH 映射为NONE时PinchGestureFinder即停止监听。onTouchEvent()是final方法未激活时直接返回false避免无谓计算触点记录每个 finder 持有PointF[] mPoints捏合和滚动为 2 点轻点为 1 点用于后续动作定位连续值计算computeValue(currValue, minValue, maxValue)是 CONTINUOUS 动作的取值入口基类统一做上下限钳制见下文“防抖”一节。捏合ScaleGestureDetector 加灵敏度系数PinchGestureFinder使用ScaleGestureDetector.SimpleOnScaleGestureListener在onScale回调中计算增量因子PinchGestureFinder.java#L23-L30mFactor ((detector.getScaleFactor() - 1) * ADD_SENSITIVITY); // ADD_SENSITIVITY 2fgetValue()中再把因子缩放到目标值域并累加到当前值add * (maxValue - minValue); return currValue add;。也就是说每次onScale事件都会产生一次“当前值 缩放增量”的更新增量被放大了 2 倍以提升手感。Android 4.4 上还禁用了 QuickScale双指快速下压直接触发缩放保证行为一致。轻点与长按一次探测两种手势TapGestureFinder用一个GestureDetector同时识别TAP和LONG_TAPonSingleTapUp回调置mType Gesture.TAPonLongPress回调置mType Gesture.LONG_TAPTapGestureFinder.java#L22-L44并启用了长按检测setIsLongpressEnabled(true)。检测到手势后持续回传手指坐标getPoint(0)直到ACTION_DOWN重置通知标志。源码中有一段被注释的onDoubleTapTODO说明双击手势在结构上是预留的但当前版本未启用。滚动先判定方向再锁死方向ScrollGestureFinder的onScroll回调实现了“首次位移定方向”的策略ScrollGestureFinder.java#L28-L51第一次onScroll时比较|distanceX|与|distanceY|较大者决定本次滑动归为SCROLL_HORIZONTAL还是SCROLL_VERTICAL之后整个手势过程不再改变类型。方向因子按视口尺寸归一化mFactor horizontal ? (distanceX / controller.getWidth()) : (distanceY / controller.getHeight()); mFactor horizontal ? -mFactor : mFactor; // When vertical, up positive垂直方向上“向上滑动为正值”符合曝光补偿、变焦的直觉往上滑放大/变亮。getValue()中因子先放大值域跨度再乘 2 提升灵敏度。此外该 finder 显式禁用了长按setIsLongpressEnabled(false)避免与长按手势互相干扰。事件分发层CameraView 如何消费手势触摸事件入口CameraView重写了两个关键回调onInterceptTouchEvent()只要mActiveGestures 0即至少有一个手势映射了非NONE动作就“劫持”触摸事件保证手势能到达自己的 finder 而不是被子 View 吃掉onTouchEvent()先检查相机已打开isOpened()然后按pinch → scroll → tap的优先级依次把事件喂给三个 finder第一个返回true的 finder 触发onGesture()处理。mActiveGestures的维护在mapGesture()内部完成每次映射成功后重新统计映射表中非NONE动作的数量CameraView.java#L613-L616。动作分发onGesture 的 switch 逻辑手势确认后onGesture() 按映射的动作执行对应调用链动作实际调用说明TAKE_PICTUREtakePicture()走完整拍照流程TAKE_PICTURE_SNAPSHOTtakePictureSnapshot()仅截取当前预览帧AUTO_FOCUSMeteringRegions.fromPoint(size, points[0])→mCameraEngine.startAutoFocus(gesture, regions, points[0])以手指坐标构造测光区域引擎侧再检查设备支持ZOOMmCameraEngine.setZoom(newValue, points, true)取值范围固定0 ~ 1归一化变焦值EXPOSURE_CORRECTIONmCameraEngine.setExposureCorrection(newValue, bounds, points, true)取值范围来自CameraOptions的getExposureCorrectionMinValue()/MaxValue()FILTER_CONTROL_1((OneParameterFilter) getFilter()).setParameter1(newValue)仅当当前滤镜是OneParameterFilter时生效值域0 ~ 1FILTER_CONTROL_2((TwoParameterFilter) getFilter()).setParameter2(newValue)仅当当前滤镜是TwoParameterFilter时生效值域0 ~ 1注意FILTER_CONTROL_*的防御性检查如果当前滤镜没有对应参数例如对无参滤镜映射了FILTER_CONTROL_1源码结构显示该分支会直接跳过不产生任何效果——因此选择滤镜参数手势前建议先确认当前Filter实现的参数个数。另外AUTO_FOCUS分支调用引擎的startAutoFocus(gesture, regions, point)抽象定义见 CameraEngine.java#L710Camera1/Camera2 引擎各自实现手势来源会随参数一并传递可用于区分“手势触发”与“API 直接调用”的测光请求。连续值的防抖GRANULARITY 机制CONTINUOUS 手势每帧都会产生新值但 GestureFinder.capValue() 会过滤掉“太小”的更新把[minValue, maxValue]区间按GRANULARITY 50等分若新值与旧值距离不足半个间隔即变化小于值域的 1/100直接返回旧值。这样在onTouchEvent侧的if (newValue ! oldValue)判断下可以显著减少无效的参数下发次数避免相机参数接口被高频抖动请求冲刷。相关 API 速查方法说明mapGesture(Gesture, GestureAction)把手势映射到动作。若两者不可赋值类型不匹配会改为映射NONE并返回falsegetGestureAction(Gesture)返回当前手势映射的动作CameraView.java#L638-L642clearGesture(Gesture)清空映射等价于mapGesture(gesture, GestureAction.NONE)CameraView.java#L628-L630mapGesture的返回值值得注意从源码看CameraView.java#L589-L622非法映射不会抛异常而是静默地把该手势清为NONE并返回false因此生产代码中应根据返回值提示用户“当前设备/配置不支持该组合”。在 Demo 中观察手势映射的过滤逻辑仓库内的 demo 工程 为五种手势各生成了一个可交互选项其getAll()方法同时应用了两重过滤是运行时验证设备能力的现成参考override fun getAll(view: CameraView, options: CameraOptions): CollectionGestureAction { return GestureAction.values().filter { gesture.isAssignableTo(it) options.supports(it) } }第一个条件是映射矩阵类型一致第二个条件查询真实传感器支持CameraOptions.supports()。两者取交集后UI 里才向用户展示该手势“当前真正可用的动作集合”。小结CameraView 的手势系统可以用一条主线概括Gesture/GestureAction两个枚举通过GestureTypeONE_SHOT / CONTINUOUS约束合法映射mapGesture()Java或cameraGesture*属性XML写入统一的mGestureMap并激活对应的GestureFinder触摸事件经onTouchEvent()分发给三个基于系统ScaleGestureDetector/GestureDetector的探测器命中后由onGesture()的 switch 把动作落到拍照、变焦、曝光补偿、触摸测光和滤镜参数上GRANULARITY防抖机制抑制无效更新。理解了这套机制你就可以在保持系统级手势识别质量的同时自由定制 App 的相机交互模型并用CameraOptions.supports()保证在目标设备上“映射必有效”。赞分享移动开发音视频【免费下载链接】CameraView A well documented, high-level Android interface that makes capturing pictures and videos easy, addressing all of the common issues and needs. Real-time filters, gestures, watermarks, frame processing, RAW, output of any size.项目地址https://gitcode.com/gh_mirrors/ca/CameraView点击查看免费下载相关推荐CameraView手势控制终极指南5种手势实现专业相机操作CameraView手势控制终极指南5种手势实现专业相机操作 CameraView是Android平台上功能强大且文档完善的相机接口库它让图片和视频拍摄变得移动开发音视频CameraView终极指南如何用一行代码解决Android相机开发难题CameraView终极指南如何用一行代码解决Android相机开发难题 CameraView是一个功能强大、文档完善的Android相机库它让拍照和录像变移动开发音视频CameraView手势控制完全指南CameraView手势控制完全指南 手势控制概述 CameraView提供了丰富的手势识别功能开发者可以通过简单配置实现各种相机控制操作。手势控制是现代相机移动开发音视频上一篇Wand-EnhancerWeMod高级功能增强与远程控制终极指南下一篇3分钟快速掌握WandEnhancer完整使用指南免费解锁WeMod高级功能创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考