微信风格相机控件：CJT2325/CameraView 安装与配置完全指南

项目基础介绍及编程语言

CJT2325/CameraView 是一个基于 Android 的开源相机控件，其设计灵感来源于微信的拍照体验，支持轻触拍照和长按摄像功能。此项目广泛适用于需要集成简单易用相机功能的 Android 应用。项目采用 Java 为主要编程语言，并兼容 Kotlin 开发。

关键技术和框架

• 核心库: 自定义视图实现，结合 Camera1 和 Camera2 API 来适配不同Android版本。
• UI设计: 支持高度定制化，如切换前后摄像头图标、录制按钮等。
• 手势识别: 实现轻触、长按以及滑动控制功能。
• 视频录制: 内置视频录制功能，支持视频时长限制和质量调整。
• 权限管理: 动态申请必要的相机、录音权限。

准备工作与详细安装步骤

步骤一：环境准备

确保你的开发环境已经搭建好 Android Studio，并且 SDK Manager 中包含了对应的 Android 平台工具及API级别支持。

步骤二：获取项目代码

1. 克隆仓库：通过命令行或者Git客户端，克隆项目至本地。

   git clone https://github.com/CJT2325/CameraView.git
   

2. 导入项目：在Android Studio中，选择 Open an existing Android Studio project，然后导航到你刚才克隆的目录打开项目。

步骤三：添加依赖

方法一：Gradle依赖

在你的项目的 build.gradle(Module: app) 文件中的dependencies块添加以下依赖：

implementation 'cjt.library.wheel:camera:1.1.9'

如果添加不成功，可能是因为仓库未找到，此时需要在 build.gradle(Project: YourProjectName) 的allProjects部分添加JCenter或指定的Maven地址:

allprojects {
    repositories {
        jcenter()
        maven { url 'https://dl.bintray.com/cjt/maven' }
    }
}

方法二：手动引入

如果你更倾向于手动导入源代码，需将 CameraView 目录下的 lib 模块作为一个Library模块引入你的项目中，然后在你的主模块中添加对该Library的依赖。

步骤四：配置权限

确保 AndroidManifest.xml 中加入了必要的权限：

<uses-permission android:name="android.permission.CAMERA"/>
<uses-permission android:name="android.permission.RECORD_AUDIO"/>
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
<!-- 如果目标API是29及以上，还需添加下面的存储权限 -->
<uses-permission android:name="android.permission.MANAGE_EXTERNAL_STORAGE" />
<!-- 若使用屏幕常亮功能 -->
<uses-permission android:name="android.permission.WAKE_LOCK"/>

步骤五：在布局文件中使用CJT2325/CameraView

在你的XML布局文件中添加JCameraView组件：

<com.cjt2325.cameralibrary.JCameraView
    android:id="@+id/jcameraview"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    app:duration_max="10000" <!-- 视频最大录制时间 -->
    app:iconSize="30dp" <!-- 摄像头切换图标大小 -->
    app:iconMargin="20dp" <!-- 图标边距 -->
    app:iconSrc="@drawable/ic_camera_icon" />

步骤六：初始化和配置JCameraView

在你的Activity或Fragment中初始化JCameraView并进行相关配置：

JCameraView jCameraView = findViewById(R.id.jcameraview);
jCameraView.setSaveVideoPath(getExternalFilesDir(null).getPath()); // 设置视频保存路径
jCameraView.setFeatures(JCameraView.BUTTON_STATE_BOTH); // 设置按钮状态，既可以拍照也可以录像
jCameraView.setOnRecordListener(new OnRecordListener() { // 设置记录监听
    @Override
    public void onStop(String filePath) {
        // 录制结束后的处理逻辑
    }

    @Override
    public void onCancel() {
        // 录制取消的处理逻辑
    }
});

步骤七：适配全屏模式（可选）

为了让应用界面更为沉浸式，你可以按照Android系统版本设置全屏模式。

至此，您已成功接入CJT2325/CameraView，可以根据具体需求进行进一步的定制和开发。记得在实际开发过程中测试不同设备上的表现，以确保兼容性。