# ViewfinderView **Repository Path**: mirrors/ViewfinderView ## Basic Information - **Project Name**: ViewfinderView - **Description**: ViewfinderView 是一个取景视图:主要用于渲染扫描相关的动画效果 - **Primary Language**: Java - **License**: Apache-2.0 - **Default Branch**: master - **Homepage**: https://www.oschina.net/p/ViewfinderView - **GVP Project**: No ## Statistics - **Stars**: 3 - **Forks**: 3 - **Created**: 2023-04-19 - **Last Updated**: 2025-10-18 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # ViewfinderView [![MavenCentral](https://img.shields.io/maven-central/v/com.github.jenly1314/viewfinderview?logo=sonatype)](https://repo1.maven.org/maven2/com/github/jenly1314/ViewfinderView) [![JitPack](https://img.shields.io/jitpack/v/github/jenly1314/ViewfinderView?logo=jitpack)](https://jitpack.io/#jenly1314/ViewfinderView) [![CI](https://img.shields.io/github/actions/workflow/status/jenly1314/ViewfinderView/build.yml?logo=github)](https://github.com/jenly1314/ViewfinderView/actions/workflows/build.yml) [![Download](https://img.shields.io/badge/download-APK-brightgreen?logo=github)](https://raw.githubusercontent.com/jenly1314/ViewfinderView/master/app/release/app-release.apk) [![API](https://img.shields.io/badge/API-21%2B-brightgreen?logo=android)](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) [![License](https://img.shields.io/github/license/jenly1314/ViewfinderView?logo=open-source-initiative)](https://opensource.org/licenses/apache-2-0) **ViewfinderView** 是一个取景视图:主要用于渲染扫描相关的动画效果。其样式主要分为两大类:`classic`:经典样式(带扫描框)、`popular`:流行样式(不带扫描框);可任意定制。 > 如果你之前有使用过 [ZXingLite](https://github.com/jenly1314/ZXingLite) 或 [MLKit](https://github.com/jenly1314/MLKit),可能会用到其内部的 **ViewfinderView**。现已将 **ViewfinderView** 独立出来,便于后续统一维护。 > 目前[ZXingLite](https://github.com/jenly1314/ZXingLite)、[MLKit](https://github.com/jenly1314/MLKit)、[WeChatQRCode](https://github.com/jenly1314/WeChatQRCode) 都已使用了此 **ViewfinderView** 作为通用的扫描渲染视图。 ## 效果展示 ![Image](GIF.gif) > 你也可以直接下载 [演示App](https://raw.githubusercontent.com/jenly1314/ViewfinderView/master/app/release/app-release.apk) 体验效果 ## 引入 ### Gradle: 1. 在Project的 **build.gradle** 或 **setting.gradle** 中添加远程仓库 ```gradle repositories { //... mavenCentral() } ``` 2. 在Module的 **build.gradle** 中添加依赖项 ```gradle implementation 'com.github.jenly1314:viewfinderview:1.4.0' ``` ## 使用 ### ViewfinderView属性说明 | 属性 | 属性类型 | 默认值 | 属性说明 | |:-------------------------|:----------|:-------------------------------------|:------------------------------------------------------| | vvViewfinderStyle | enum | classic | 取景框样式;支持`classic`:经典样式(带扫描框)、`popular`:流行样式(不带扫描框) | | vvMaskColor | color | #60000000 | 扫描区外遮罩的颜色 | | vvFrameColor | color | #7F1FB3E2 | 扫描框边框的颜色 | | vvFrameWidth | dimension | | 扫描框宽度 | | vvFrameHeight | dimension | | 扫描框高度 | | vvFrameRatio | float | 0.625f | 扫描框与屏幕占比,当未设置扫描框的宽高时,使用占比来计算宽高 | | vvFrameLineStrokeWidth | dimension | 1dp | 边框线宽度 | | vvFramePaddingLeft | dimension | 0 | 扫描框左边的内间距 | | vvFramePaddingTop | dimension | 0 | 扫描框上边的内间距 | | vvFramePaddingRight | dimension | 0 | 扫描框右边的内间距 | | vvFramePaddingBottom | dimension | 0 | 扫描框下边的内间距 | | vvFrameGravity | enum | center | 扫描框对齐方式 | | vvFrameCornerColor | color | #FF1FB3E2 | 扫描框边角的颜色 | | vvFrameCornerSize | dimension | 16dp | 扫描框边角的大小 | | vvFrameCornerStrokeWidth | dimension | 4dp | 扫描框边角的描边宽度 | | vvFrameCornerRadius | dimension | 0dp | 扫描框圆角半径 | | vvFrameDrawable | reference | | 扫描框自定义图片 | | vvLaserLineHeight | dimension | 5dp | 激光扫描线高度 | | vvLaserMovementSpeed | dimension | 2dp | 激光扫描线的移动速度 | | vvLaserAnimationInterval | integer | 20 | 扫描动画延迟间隔时间,单位:毫秒 | | vvLaserGridColumn | integer | 20 | 网格激光扫描列数 | | vvLaserGridHeight | dimension | 40dp | 网格激光扫描高度,为0dp时,表示动态铺满 | | vvLaserGridStrokeWidth | dimension | 1dp | 网格线条的宽 | | vvLaserColor | color | #FF1FB3E2 | 扫描区激光线的颜色 | | vvLaserStyle | enum | line | 激光扫描的样式 | | vvLaserDrawable | reference | | 激光扫描线自定义图片 | | vvLaserDrawableRatio | float | 0.625f | 激光扫描图片与屏幕占比 | | vvLabelText | string | | 扫描提示文本信息 | | vvLabelTextColor | color | #FFC0C0C0 | 提示文本字体颜色 | | vvLabelTextSize | dimension | 14sp | 提示文本字体大小 | | vvLabelTextPadding | dimension | 24dp | 提示文本距离扫描框的间距 | | vvLabelTextWidth | dimension | | 提示文本的宽度,默认为View的宽度 | | vvLabelTextLocation | enum | bottom | 提示文本显示位置 | | vvPointColor | color | #FF1FB3E2 | 结果点的颜色 | | vvPointStrokeColor | color | #FFFFFFFF | 结果点描边的颜色 | | vvPointRadius | dimension | 15dp | 结果点的半径 | | vvPointStrokeRatio | float | 1.2 | 结果点描边半径与结果点半径的比例 | | vvPointDrawable | reference | | 结果点自定义图片 | | vvPointAnimation | boolean | true | 是否显示结果点的动画 | | vvPointAnimationInterval | integer | 3000 | 结果点动画间隔时长;单位:毫秒 | | vvFullRefresh | boolean | false | 是否完全刷新;适用于`vvViewfinderStyle`为`classic`经典样式(带扫描框)时 | > ViewfinderView相关的自定义属性统一使用 **vv** 开头。 ### 示例 #### 布局示例 ViewfinderView 相关的自定义属性可查看上面的 [ViewfinderView属性说明](#ViewfinderView属性说明) ```xml ``` 更多使用详情,请查看[app](app)中的源码使用示例或直接查看 [API帮助文档](https://jenly1314.github.io/ViewfinderView/api/) ## 相关推荐 - [ZXingLite](https://github.com/jenly1314/ZXingLite) 基于zxing实现的扫码库,优化扫码和生成二维码/条形码功能。 - [MLKit](https://github.com/jenly1314/MLKit) 一个强大易用的工具包。通过ML Kit您可以很轻松的实现文字识别、条码识别、图像标记、人脸检测、对象检测等功能。 - [WeChatQRCode](https://github.com/jenly1314/WeChatQRCode) 基于OpenCV开源的微信二维码引擎移植的扫码识别库。 - [CameraScan](https://github.com/jenly1314/CameraScan) 一个简化扫描识别流程的通用基础库。 - [LibYuv](https://github.com/jenly1314/LibYuv) 基于Google的libyuv编译封装的YUV转换工具库,主要用途是在各种YUV与RGB之间进行相互转换、裁减、旋转、缩放、镜像等。 ## 版本日志 #### v1.4.0:2025-7-7 * 迁移发布至 **Central Portal** [相关公告](https://central.sonatype.org/pages/ossrh-eol/#logging-in-to-central-portal) * 更新Gradle至v8.5 * 优化一些细节 #### [查看更多版本日志](CHANGELOG.md) --- ![footer](https://jenly1314.github.io/page/footer.svg)