Customized View支持您自定义扫码界面,扫码过程和相机控制将由Scan Kit完成。您可以参见我们提供的示例代码快速构建扫码界面UI。
使用此种模式时请确保您的应用没有关闭硬件加速,即“hardwareAccelerated”为“true”。否则在个别机型可能会出现黑屏问题。
使用Customized View Mode的主要业务流程如下:
在相机预览流中,Scan Kit只截取扫码识别区域的图像,为了获得较好的自动放大效果,建议扫码框放在屏幕中间,且扫码识别区域比绘制的扫码框范围略大。
您可以指定Scan Kit只扫码特定的码制式,以提高扫码速度。例如,当仅需要检测QR码和DataMatrix码时,通过setFormat(HmsScan.QRCODE_SCAN_TYPE, HmsScan.DATAMATRIX_SCAN_TYPE)方法实现。当不指定特定的码制式时,不需要调用setFormat方法,默认检测Scan Kit支持的码制式。
“Java”
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_defined);
// 绑定相机预览布局
frameLayout = findViewById(R.id.rim);
// 设置扫码识别区域,您可以按照需求调整参数
DisplayMetrics dm = getResources().getDisplayMetrics();
float density = dm.density;
mScreenWidth = getResources().getDisplayMetrics().widthPixels;
mScreenHeight = getResources().getDisplayMetrics().heightPixels;
// 当前Demo扫码框的宽高是300dp
final int SCAN_FRAME_SIZE = 300;
int scanFrameSize = (int) (SCAN_FRAME_SIZE * density);
Rect rect = new Rect();
rect.left = mScreenWidth / 2 - scanFrameSize / 2;
rect.right = mScreenWidth / 2 + scanFrameSize / 2;
rect.top = mScreenHeight / 2 - scanFrameSize / 2;
rect.bottom = mScreenHeight / 2 + scanFrameSize / 2;
// 初始化RemoteView,并通过如下方法设置参数:setContext()(必选)传入context、setBoundingBox()设置扫描区域、setFormat()设置识别码制式,设置完毕调用build()方法完成创建。通过setContinuouslyScan(可选)方法设置非连续扫码
remoteView = new RemoteView.Builder().setContext(this).setBoundingBox(rect).setContinuouslyScan(false).setFormat(HmsScan.QRCODE_SCAN_TYPE, HmsScan.DATAMATRIX_SCAN_TYPE).build();
// 将自定义view加载到activity的frameLayout中
remoteView.onCreate(savedInstanceState);
FrameLayout.LayoutParams params = new FrameLayout.LayoutParams(LinearLayout.LayoutParams.MATCH_PARENT, LinearLayout.LayoutParams.MATCH_PARENT);
frameLayout.addView(remoteView, params);
} “Kotlin”
override fun onCreate(savedInstanceState:Bundle?) {
super.onCreate(savedInstanceState)
setContentView(R.layout.activity_defined)
// 绑定相机预览布局
frameLayout = findViewById(R.id.rim)
// 设置扫码识别区域,您可以按照需求调整参数
val dm = getResources().getDisplayMetrics()
val density = dm.density
mScreenWidth = getResources().getDisplayMetrics().widthPixels
mScreenHeight = getResources().getDisplayMetrics().heightPixels
// 当前Demo扫码框的宽高是300dp
val SCAN_FRAME_SIZE = 300
val scanFrameSize = (SCAN_FRAME_SIZE * density).toInt()
val rect = Rect()
rect.left = (mScreenWidth / 2 - scanFrameSize / 2).toInt()
rect.right = (mScreenWidth / 2 + scanFrameSize / 2).toInt()
rect.top = (mScreenHeight / 2 - scanFrameSize / 2).toInt()
rect.bottom = (mScreenHeight / 2 + scanFrameSize / 2).toInt()
// 初始化RemoteView,并通过如下方法设置参数:setContext()(必选)传入context、setBoundingBox()设置扫描区域、setFormat()设置识别码制式,设置完毕调用build()方法完成创建。通过setContinuouslyScan(可选)方法设置非连续扫码
remoteView = RemoteView.Builder().setContext(this).setBoundingBox(rect).setContinuouslyScan(false).setFormat(HmsScan.QRCODE_SCAN_TYPE, HmsScan.DATAMATRIX_SCAN_TYPE).build()
// 将自定义view加载到activity的frameLayout中
remoteView.onCreate(savedInstanceState)
val params = FrameLayout.LayoutParams(LinearLayout.LayoutParams.MATCH_PARENT, LinearLayout.LayoutParams.MATCH_PARENT)
frameLayout.addView(remoteView, params)
} “Java”
@Override
protected void onCreate(Bundle savedInstanceState) {
…
// 识别结果回调事件订阅
remoteView.setOnResultCallback(new OnResultCallback() {
@Override
public void onResult(HmsScan[] result) {
// 获取到扫码结果HmsScan
...
}
});
} “Kotlin”
override
fun onCreate(savedInstanceState:Bundle?) {
…
// 识别结果回调事件订阅
remoteView?.setOnResultCallback(OnResultCallback {
// 获取到扫码结果HmsScan
...
})
} “Java”
@Override
protected void onStart() {
super.onStart();
// 侦听activity的onStart
remoteView.onStart();
}
@Override
protected void onResume() {
super.onResume();
// 侦听activity的onResume
remoteView.onResume();
}
@Override
protected void onPause() {
super.onPause();
// 侦听activity的onPause
remoteView.onPause();
}
@Override
protected void onStop() {
super.onStop();
// 侦听activity的onStop
remoteView.onStop();
}
@Override
protected void onDestroy() {
super.onDestroy();
// 侦听activity的onDestroy
remoteView.onDestroy();
} “Kotlin”
override
protected fun onStart() {
super.onStart()
// 侦听activity的onStart
remoteView?.onStart()
}
override
protected fun onResume() {
super.onResume()
// 侦听activity的onResume
remoteView?.onResume()
}
override
protected fun onPause() {
super.onPause()
// 侦听activity的onPause
remoteView?.onPause()
}
override
protected fun onStop() {
super.onStop()
// 侦听activity的onStop
remoteView?.onStop()
}
override
protected fun onDestroy() {
super.onDestroy()
// 侦听activity的onDestroy
remoteView?.onDestroy()
} “Java”
protected void onCreate(Bundle savedInstanceState) {
…
// 光线暗时,会回调该接口,用于控制显示闪光灯开关
flushBtn = findViewById(R.id.flush_btn);
remoteView.setOnLightVisibleCallback(new OnLightVisibleCallBack() {
@Override
public void onVisibleChanged(boolean visible) {
if(visible){
flushBtn.setVisibility(View.VISIBLE);
}
}
});
…
} “Kotlin”
protected fun onCreate(savedInstanceState:Bundle?) {
…
// 光线暗时,会回调该接口,用于控制显示闪光灯开关
flushBtn = findViewById(R.id.flush_btn)
remoteView?.setOnLightVisibleCallback(OnLightVisibleCallBack{
if(it){
flushBtn?.setVisibility(View.VISIBLE)
}
})
…
}
暂停扫码会重置相机焦距。例如,若焦距处在放大状态,暂停扫码并恢复扫码后,焦距恢复正常状态。
“Java”
// setContinuouslyScan设置为false,非连续扫码
remoteView = new RemoteView.Builder().setContext(this).setContinuouslyScan(false).build(); “Kotlin”
// setContinuouslyScan设置为false,非连续扫码
remoteView = RemoteView.Builder().setContext(this).setContinuouslyScan(false).build() “Java”
remoteView = new RemoteView.Builder().setContext(this).enableReturnBitmap().build(); “Kotlin”
remoteView = RemoteView.Builder().setContext(this).enableReturnBitmap().build()
如果扫码后需要返回用户提交的原图,请向用户告知。并且您需要满足当地法律法规的要求。