@ -1,31 +1,15 @@
# AndroidUSBCamera开源项目OkCamera
### AndroidUSBCamera基于[saki4510t/UVCCamera](https://github.com/saki4510t/UVCCamera)开发，该项目对USB Camera(UVC设备)的使用和视频数据采集进行了高度封装，能够帮助开发者通过几个简单的API实现USB Camera设备的检测、连接、预览和音视频数据采集，最重要的是手机无需root，只需支持otg功能即可驱动。主要功能包括： ============
(1)支持USB Camera设备检测，画面实时预览; AndroidUSBCamera is developed based on the [saki4510t/UVCCamera ](https://github.com/saki4510t/UVCCamera ), the project of USB Camera (UVC equipment) and the use of video data acquisition are highly packaged, and it can help developers using USB Camera devices easily by a few simple APIs. By using AndroidUSBCamera,you can detect and connect to a USB Camera simply.And you also can use it to realize taking picture,recording mp4,switching resolutions and setting camera's contrast or brightness,etc.
(2)支持本地录制mp4格式视频,支持实时获取音视频数据流;
(3)支持jpg格式图片抓拍; [中文文档： AndroidUSBCamera，UVCCamera开发通用库 ](http://blog.csdn.net/andrexpert/article/details/78324181 )
(4)支持获取camera支持的分辨率，和分辨率切换;
(5)支持屏蔽声音,重启Camera; Usage
(6)支持相机自动对焦； -------
(7)支持调整对比度和亮度### 1.Add to your Android Studio project
> AndroidUSBCamera is developed based on the saki4510t/UVCCamera, the project of USB Camera (UVC equipment) and the use of video data acquisition are highly packaged, and it can help developers using USB Camera devices to connect, preview and video data collection by a few simple API. The main functions include: Step 1. Add the JitPack repository to your build file.Add it in your root build.gradle at the end of repositories:
(1)supports detecting USB Camera equipment, and previewing; ```java
(2)supports recording MP4 format video, and acquiring real-time audio and video data;
(3)supports capturing JPG format image;
(4)supports getting supported preview sizes，and switching resolution;
(5)supports shielding sound;
(6)supports camera auto foucs;
(7)supports change camera's contrast and brightness
## 如何使用AndroidUSBCamera项目
### 1.添加依赖到本地工程
To get a Git project into your build:
第一步 添加JitPack仓库到工程gradle
Step 1. Add the JitPack repository to your build file
Add it in your root build.gradle at the end of repositories:
```
allprojects {allprojects {
repositories { repositories {
... ...
@ -34,220 +18,144 @@ allprojects {
} }
} }
``` ```
第二步 添加依赖到app Module的gradle
Step 2. Add the dependency Step 2. Add the dependency
```java
```
dependencies { dependencies {
compile 'com.github.jiangdongguo:AndroidUSBCamera:1.3.9 ' compile 'com.github.jiangdongguo:AndroidUSBCamera:2.0 '
} }
``````
### 2. APIs Introduction
### 2.初始化引擎，注册USB设备事件监听器 (1) In order to using it correctly,the following four steps must be achieved：
Init AndroidUSBCamera engine，register the USB device event listener ```java
mUVCCameraView = (CameraViewInterface) mTextureView;
```mUVCCameraView.setCallback(mCallback);
private USBCameraManager.OnMyDevConnectListener listener = new USBCameraManager.OnMyDevConnectListener() {mCameraHelper = UVCCameraHelper.getInstance();
// 插入USB设备mCameraHelper.initUSBMonitor(this, mUVCCameraView, mDevConnectListener);
```
To be attention,mCallback is a object of interface CameraViewInterface.Callback,and it's used to be listenering surfaceView
created or detoryed.mDevConnectListener is a object of interface UVCCameraHelper.OnMyDevConnectListener,and it's used to be listenering to detect and conntect USB device.Here is the coding order:
```java
private CameraViewInterface.Callback mCallback = new CameraViewInterface.Callback mCallback(){
@Override @Override
public void onAttachDev(UsbDevice device) { public void onSurfaceCreated(CameraViewInterface view, Surface surface) {
if(mUSBManager == null || mUSBManager.getUsbDeviceCount() == 0){ // must have
showShortMsg("未检测到USB摄像头设备"); if (!isPreview & & mCameraHelper.isCameraOpened()) {
return; mCameraHelper.startPreview(mUVCCameraView);
} isPreview = true;
// 请求打开摄像头
if(! isRequest){
isRequest = true;
if(mUSBManager != null){
mUSBManager.requestPermission(0);
}
} }
} }
// 拔出USB设备
@Override @Override
public void onDettachDev(UsbDevice device) { public void onSurfaceChanged(CameraViewInterface view, Surface surface, int width, int height) {
if(isRequest){
// 关闭摄像头
isRequest = false;
mUSBManager.closeCamera();
showShortMsg(device.getDeviceName()+"已拨出");
}
} }
// 连接USB设备成功
@Override @Override
public void onConnectDev(UsbDevice device,boolean isConnected) { public void onSurfaceDestroy(CameraViewInterface view, Surface surface) {
if(! isConnected) { // must have
showShortMsg("连接失败，请检查分辨率参数是否正确"); if (isPreview & & mCameraHelper.isCameraOpened()) {
mCameraHelper.stopPreview();
isPreview = false; isPreview = false;
}else{
isPreview = true;
}
} }
// 与USB设备断开连接
@Override
public void onDisConnectDev(UsbDevice device) {
showShortMsg("连接失败");
} }
};}
private UVCCameraHelper.OnMyDevConnectListener listener = new UVCCameraHelper.OnMyDevConnectListener() {
mUVCCameraView = (CameraViewInterface) mTextureView;
mUVCCameraView.setCallback(new CameraViewInterface.Callback() {
@Override @Override
public void onSurfaceCreated(CameraViewInterface view, Surface surface) { public void onAttachDev(UsbDevice device) {
if(!isPreview & & mUSBManager.isCameraOpened()) { // request open permission(must have)
mUSBManager.startPreview(mUVCCameraView, new AbstractUVCCameraHandler.OnPreViewResultListener() { if (!isRequest) {
@Override isRequest = true;
public void onPreviewResult(boolean result) { if (mCameraHelper != null) {
mCameraHelper.requestPermission(0);
}
});
isPreview = true;
} }
} }
@Override
public void onSurfaceChanged(CameraViewInterface view, Surface surface, int width, int height) {
} }
@Override @Override
public void onSurfaceDestroy(CameraViewInterface view, Surface surface) { public void onDettachDev(UsbDevice device) {
if(isPreview & & mUSBManager.isCameraOpened()) { // close camera(must have)
mUSBManager.stopPreview(); if (isRequest) {
isPreview = false; isRequest = false;
mCameraHelper.closeCamera();
} }
} }
});
// 初始化引擎
mUSBManager = USBCameraManager.getInstance();
mUSBManager.initUSBMonitor(this,listener);
mUSBManager.createUVCCamera(mUVCCameraView);
``` @Override
public void onConnectDev(UsbDevice device, boolean isConnected) {
### 3. 注册USB设备广播事件监听器，开始Camera预览
Register the USB device broadcast event listener and start the Camera Preview
```
// 注册USB事件广播监听器
if(mUSBManager != null){
mUSBManager.registerUSB();
}
// 恢复Camera预览
if(mUVCCameraView != null){
mUVCCameraView.onResume();
} }
```
### 4. 注销USB设备广播事件监听器，停止Camera预览 @Override
Unregister the USB device broadcast event listener and stop the Camera Preview public void onDisConnectDev(UsbDevice device) {
```
// 注销USB事件广播监听器
if(mUSBManager != null){
mUSBManager.unregisterUSB();
}
// 暂停Camera预览
if(mUVCCameraView != null){
mUVCCameraView.onPause();
}
```
### 5. 图片抓拍
Picture capturing
```
if(mUSBManager == null || ! mUSBManager.isCameraOpened()){
showShortMsg("抓拍异常，摄像头未开启");
return;
} }
mUSBManager.capturePicture(picPath, new AbstractUVCCameraHandler.OnCaptureListener() { };
```
(2) Capturing JPG Images
```java
mCameraHelper.capturePicture(picPath, new AbstractUVCCameraHandler.OnCaptureListener() {
@Override @Override
public void onCaptureResult(String path) { public void onCaptureResult(String path) {
showShortMsg("保存路径："+path); Log.i(TAG,"save path：" + path);
} }
}); });
```
### 6. 本地录制(可实时获取音视频数据流)
recoring mp4，and get media real-stream
``````
if(mUSBManager == null || ! mUSBManager.isCameraOpened()){(3) Recording Mp4,supporting close voice and save file automatic.
showShortMsg("录制异常，摄像头未开启");```java
return;RecordParams params = new RecordParams();
}
if(! mUSBManager.isRecording()){
String videoPath = USBCameraManager.ROOT_PATH+System.currentTimeMillis();
FileUtils.createfile(FileUtils.ROOT_PATH+"test666.h264");
RecordParams params = new RecordParams();
params.setRecordPath(videoPath); params.setRecordPath(videoPath);
params.setRecordDuration(0); // 设置为0，不分割保存 params.setRecordDuration(0); // 0,do not cut save
params.setVoiceClose(false); // 不屏蔽声音 params.setVoiceClose(mSwitchVoice.isChecked()); // is close voice
mUSBManag er.startRecording(params, new AbstractUVCCameraHandler.OnEncodeResultListener() { mCameraHelper.startRecording(params, new AbstractUVCCameraHandler.OnEncodeResultListener() {
@Override @Override
public void onEncodeResult(byte[] data, int offset, int length, long timestamp, int type) { public void onEncodeResult(byte[] data, int offset, int length, long timestamp, int type) {
// type = 0,aac格式音频流 // type = 1,h264 video stream
// type = 1,h264格式视频流 if (type == 1) {
if(type == 1){// FileUtils.putFileStream(data, offset, length);
FileUtils.putFileStream(data,offset,length);
}
} }
// type = 0,aac audio stream
if(type == 0) {
@Override
public void onRecordResult(String videoPath) {
showShortMsg(videoPath);
} }
}); }
// 停止录制
mUSBManager.stopRecording();
```
### 7. 切换分辨率
update Resulotion
```
mUSBManager.updateResolution(this, mUVCCameraView, 320, 240, new USBCameraManager.OnPreviewListener() {
@Override @Override
public void onPreviewResult(boolean isSuccess) { public void onRecordResult(String videoPath) {
if(! isSuccess) { Log.i(TAG,"videoPath = "+videoPath);
showShortMsg("预览失败，不支持该分辨率");
}else {
showShortMsg("以切换到分辨率为320x240");
}
} }
}); });
// 获取Camera支持得分辨率
List< Size > list = mUSBManager.getSupportedPreviewSizes();
// Camera自动对焦
mUSBManager.startCameraFoucs();
``````
(4) setting camera's brightness and contrast.
### 8. 释放引擎资源```java
release resource mCameraHelper.setModelValue(UVCCameraHelper.MODE_BRIGHTNESS,progress);
mCameraHelper.setModelValue(UVCCameraHelper.MODE_CONTRAST,progress);
mCameraHelper.getModelValue(UVCCameraHelper.MODE_BRIGHTNESS);
mCameraHelper.getModelValue(UVCCameraHelper.MODE_CONTRAST);
...
``````
// 释放资源(5) switch resolutions and camera.
if(mUSBManager != null){```java
mUSBManager.release();mCameraHelper.updateResolution(widht, height);
}
``````
### 9. 添加权限At last,remember adding permissions:
add permissions
``````
< uses-permission android:name = "android.permission.WRITE_EXTERNAL_STORAGE" / > < uses-permission android:name = "android.permission.WRITE_EXTERNAL_STORAGE" / >
< uses-permission android:name = "android.permission.RECORD_AUDIO" / > < uses-permission android:name = "android.permission.RECORD_AUDIO" / >
``` ```
### USBCameraManager API (Other)License
```-------
(1) void requestPermission(int index)：请求授予开启USB摄像头权限；
(2) int getUsbDeviceCount()：返回查询到的可用USB Camera数目； Copyright 2018 Jiangdongguo
(3) boolean isRecording()：判断是否正在录制视频；
(4) boolean isCameraOpened()：判断USB摄像头是否正常打开； Licensed under the Apache License, Version 2.0 (the "License");
(5) void release()：释放资源 you may not use this file except in compliance with the License.
(6) USBMonitor getUSBMonitor()：返回USBMonitor实例； You may obtain a copy of the License at
(7) mUSBManager.setModelValue(USBCameraManager.MODE_CONTRAST,contrast++); 调整对比度
(8) mUSBManager.setModelValue(USBCameraManager.MODE_BRIGHTNESS,brightness++);调整亮度 http://www.apache.org/licenses/LICENSE-2.0
```
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
jiangdongguo
7 years ago