-
- All Implemented Interfaces:
-
com.king.zxing.ICamera,com.king.zxing.ICameraControl
public class DefaultCameraScan extends CameraScan
相机扫描基类;DefaultCameraScan 为 CameraScan 的默认实现
快速实现扫描识别主要有以下几种方式:
1、通过继承 CaptureActivity或者CaptureFragment或其子类,可快速实现扫描识别。 (适用于大多数场景,自定义布局时需覆写getLayoutId方法)
2、在你项目的Activity或者Fragment中实例化一个DefaultCameraScan。(适用于想在扫码界面写交互逻辑,又因为项目 架构或其它原因,无法直接或间接继承CaptureActivity或CaptureFragment时使用)
3、继承CameraScan自己实现一个,可参照默认实现类DefaultCameraScan,其他步骤同方式2。(高级用法,谨慎使用)
-
-
Constructor Summary
Constructors Constructor Description DefaultCameraScan(FragmentActivity activity, PreviewView previewView)DefaultCameraScan(Fragment fragment, PreviewView previewView)
-
Method Summary
Modifier and Type Method Description CameraScansetCameraConfig(CameraConfig cameraConfig)设置相机配置,请在startCamera之前调用 voidstartCamera()启动相机预览 voidstopCamera()停止相机预览 CameraScansetAnalyzeImage(boolean analyze)设置是否分析图像,通过此方法可以动态控制是否分析图像,常用于中断扫码识别。如:连扫时,扫到结果,然后停止分析图像1. CameraScansetAnalyzer(Analyzer analyzer)设置分析器,如果内置的一些分析器不满足您的需求,你也可以自定义Analyzer,自定义时,切记需在startCamera之前调用才有效。内置了一些Analyzer的实现类如下: voidzoomIn()放大 voidzoomOut()缩小 voidzoomTo(float ratio)缩放到指定比例 voidlineZoomIn()线性放大 voidlineZoomOut()线性缩小 voidlineZoomTo(@FloatRange(from = 0.0, to = 1.0) float linearZoom)线性缩放到指定比例 voidenableTorch(boolean torch)设置闪光灯(手电筒)是否开启 booleanisTorchEnabled()闪光灯(手电筒)是否开启 booleanhasFlashUnit()是否支持闪光灯 CameraScansetVibrate(boolean vibrate)设置是否振动 CameraScansetPlayBeep(boolean playBeep)设置是否播放提示音 CameraScansetOnScanResultCallback(CameraScan.OnScanResultCallback callback)设置扫码结果回调 CameragetCamera()获取 Camera voidrelease()释放 CameraScanbindFlashlightView(@Nullable() View v)绑定手电筒,绑定后可根据光线传感器,动态显示或隐藏手电筒 CameraScansetDarkLightLux(float lightLux)设置光线足够暗的阈值(单位:lux),需要通过bindFlashlightView绑定手电筒才有效 CameraScansetBrightLightLux(float lightLux)设置光线足够明亮的阈值(单位:lux),需要通过bindFlashlightView绑定手电筒才有效 -
-
Method Detail
-
setCameraConfig
CameraScan setCameraConfig(CameraConfig cameraConfig)
设置相机配置,请在startCamera之前调用
- Parameters:
cameraConfig- 相机配置
-
startCamera
void startCamera()
启动相机预览
-
stopCamera
void stopCamera()
停止相机预览
-
setAnalyzeImage
CameraScan setAnalyzeImage(boolean analyze)
设置是否分析图像,通过此方法可以动态控制是否分析图像,常用于中断扫码识别。如:连扫时,扫到结果,然后停止分析图像
1. 因为分析图像默认为true,如果想支持连扫,在onScanResultCallback返回true拦截即可。当连扫的处理逻辑比较复杂时,请在处理逻辑前通过调用setAnalyzeImage(false)来停止分析图像,等逻辑处理完后再调用getCameraScan().setAnalyzeImage(true)来继续分析图像。
2. 如果只是想拦截扫码结果回调自己处理逻辑,但并不想继续分析图像(即不想连扫),可通过调用getCameraScan().setAnalyzeImage(false)来停止分析图像。
- Parameters:
analyze- 是否分析图像
-
setAnalyzer
CameraScan setAnalyzer(Analyzer analyzer)
设置分析器,如果内置的一些分析器不满足您的需求,你也可以自定义Analyzer,自定义时,切记需在startCamera之前调用才有效。
内置了一些Analyzer的实现类如下:
- Parameters:
analyzer- 分析器
-
zoomIn
void zoomIn()
放大
-
zoomOut
void zoomOut()
缩小
-
zoomTo
void zoomTo(float ratio)
缩放到指定比例
- Parameters:
ratio- 缩放比例
-
lineZoomIn
void lineZoomIn()
线性放大
-
lineZoomOut
void lineZoomOut()
线性缩小
-
lineZoomTo
void lineZoomTo(@FloatRange(from = 0.0, to = 1.0) float linearZoom)
线性缩放到指定比例
- Parameters:
linearZoom- 线性缩放比例;范围在:0.0 ~ 1.
-
enableTorch
void enableTorch(boolean torch)
设置闪光灯(手电筒)是否开启
- Parameters:
torch- 是否开启闪光灯(手电筒)
-
isTorchEnabled
boolean isTorchEnabled()
闪光灯(手电筒)是否开启
-
hasFlashUnit
boolean hasFlashUnit()
是否支持闪光灯
-
setVibrate
CameraScan setVibrate(boolean vibrate)
设置是否振动
- Parameters:
vibrate- 是否振动
-
setPlayBeep
CameraScan setPlayBeep(boolean playBeep)
设置是否播放提示音
- Parameters:
playBeep- 是否播放蜂鸣提示音
-
setOnScanResultCallback
CameraScan setOnScanResultCallback(CameraScan.OnScanResultCallback callback)
设置扫码结果回调
- Parameters:
callback- 扫码结果回调
-
getCamera
@Nullable() Camera getCamera()
获取 Camera
-
release
void release()
释放
-
bindFlashlightView
CameraScan bindFlashlightView(@Nullable() View v)
绑定手电筒,绑定后可根据光线传感器,动态显示或隐藏手电筒
- Parameters:
v- 手电筒视图
-
setDarkLightLux
CameraScan setDarkLightLux(float lightLux)
设置光线足够暗的阈值(单位:lux),需要通过bindFlashlightView绑定手电筒才有效
- Parameters:
lightLux- 光线亮度阈值
-
setBrightLightLux
CameraScan setBrightLightLux(float lightLux)
设置光线足够明亮的阈值(单位:lux),需要通过bindFlashlightView绑定手电筒才有效
- Parameters:
lightLux- 光线亮度阈值
-
-
-
-