From cf95f84fd1dcce16793cf6424edc1364ec2e5a5d Mon Sep 17 00:00:00 2001
From: wuxiang <wuxiang@shuto.cn>
Date: Fri, 1 Oct 2021 15:48:34 +0800
Subject: [PATCH] =?UTF-8?q?=E6=B7=BB=E5=8A=A0=E8=AF=B4=E6=98=8E=E6=96=87?=
 =?UTF-8?q?=E4=BB=B6?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 README.md | 56 +++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 56 insertions(+)
 create mode 100644 README.md

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..96933bc
--- /dev/null
+++ b/README.md
@@ -0,0 +1,56 @@
+# 短视频拍摄+压缩插件
+
+## 来源
+Android 代码根据 https://github.com/mabeijianxi/small-video-record 修改。
+
+## 安装方法
+
+`cordova plugin add git+http://m.shuto.cn:8680/center/capture-cordova-plugin.git`
+
+## 调用方法
+
+```javascript
+    /**
+      * 拍摄
+      * @Param options 拍摄参数
+      * @Param 成功callback
+      * @Param 失败callback
+      *
+      */
+    capture.capture(options, success, error);
+```
+
+```javascript
+    /**
+      * 参数说明
+      */
+    options = {
+      needFull: true, // 是否全屏预览，一般性能好些的机器都可开启
+      width: 640, // 视频宽度（相当于手机竖拍时的高度）
+      height: 480, // 视频高度
+      maxTime: 15000, // 可录制最大长度，单位：毫秒
+      minTime: 3000, // 录制最小长度，不到这个长度的会被忽略？，单位：毫秒
+      maxFramerate: 24, // 最大帧率，这个参数似乎影响不是很大
+      bitrate: 580000, // 比特率，值越大，文件越大，理论上越清晰
+      thumbnailsTime: 1 // 用作缩略图的图片的截取时间，默认第1帧
+    }
+```
+
+## 说明
+1. Android 需要设置最低 sdk 版本为24
+```xml
+<preference name="android-minSdkVersion" value="24" />
+```
+2. Android 中因使用到了外部存储 DCMI，但在 Android10（SdkVersion 29）中会出现 file.mkdir() 无法创建的问题，因此要么指定要么小于 29 的 sdk，要么添加过渡期解决方案。需要注意到 Android11（SdkVersion 30）开始这个过滤方案将失效，需要按照 Scoped Storage 的规范使用外部存储。
+- 2.1 指定 sdk 版本
+```xml
+<preference name="android-targetSdkVersion" value="25" />
+```
+- 2.2 使用过渡方案
+```xml
+<edit-config file="app/src/main/AndroidManifest.xml" mode="merge" target="/manifest/application" xmlns:android="http://schemas.android.com/apk/res/android">
+    <application android:requestLegacyExternalStorage="true" />
+</edit-config>
+```
+
+[示例 app](http://m.shuto.cn:8680/center/captureDemo.git)