Android WebView 实现文件选择、拍照、录制视频、录音

原文地址:Android WebView 实现文件选择、拍照、录制视频、录音 | Stars-One的杂货小窝

Android中的WebView如果不进行相应的设置,H5页面的上传按钮是无法触发Android弹出文件选择框的,所以,需要进行以下的设置

原理说明

Webview通过setWebChromeClient()方法来设置一个WebChromeClient对象,里面有相关的方法处理,我们需要将其相关的方法处理即可实现对应的效果(如弹出对话框,权限申请或弹出文件选择)

我们想要实现文件选择,只需要继承WebChromeClient类,重写其的onShowFileChooser()方法即可,方法如下:

boolean onShowFileChooser(WebView webView, ValueCallback filePathCallback, FileChooserParams fileChooserParams)

可以看到,onShowFileChooser()方法中存在有3个参数,分别为webview,filePathCallback和fileChooserParams

• fileChooserParams是文件选择的参数,我们可以利用此对象的方法fileChooserParams.getAcceptTypes()来知道H5中的上传组件的accept属性(即H5规定接收的文件格式)

通常情况,我们通过拿到对应的文件格式,从而弹出对应的文件选择,比如说接收的格式是图片类型,可以给出拍照或者是从图库中选择照片的两个选项

• filePathCallback是文件选择后的回调,调用filePathCallback.onReceiveValue()方法,把我们把文件的Uri传回给H5

PS:需要考虑到用户没有选择文件的情况.filePathCallback则需要传空数组回去(null也行)

代码如下:

//注意onReceiveValue方法接收的是个Uri数组
filePathCallback.onReceiveValue(new Uri[]{});

filePathCallback.onReceiveValue(null);

之后的上传操作由前端H5实现,这里就不过多展开了,前端使用相应的上传组件即可

步骤实现

1.前提权限和配置

• 选择图片需要存储权限

• 拍照和录制视频需要相机权限

记得声明和动态获取权限,这里不再赘述

同时,还要设置webview,下面给出比较全面的设置,点击展开即可查看

Webview相关的配置

WebSettings webSettings = webview.getSettings();
webSettings.setAllowFileAccess(true);
webSettings.setDomStorageEnabled(true);
webSettings.setDatabaseEnabled(true);
webSettings.setJavaScriptEnabled(true);  //支持js
webSettings.setUseWideViewPort(true);//设置此属性，可任意比例缩放
webSettings.setLoadWithOverviewMode(true);
webSettings.setBuiltInZoomControls(false);
webSettings.setDisplayZoomControls(false);
webSettings.setAllowFileAccessFromFileURLs(true);
// 视频播放需要使用
int SDK_INT = android.os.Build.VERSION.SDK_INT;
if (SDK_INT > 16) {
    webSettings.setMediaPlaybackRequiresUserGesture(false);
}
webSettings.setSupportZoom(false);//支持缩放
requestFocusFromTouch();

//跨域取消
try {
    Class clazz = getSettings().getClass();
    Method method = clazz.getMethod(
            "setAllowUniversalAccessFromFileURLs", boolean.class);
    if (method != null) {
        method.invoke(getSettings(), true);
    }
} catch (IllegalArgumentException | NoSuchMethodException | IllegalAccessException | InvocationTargetException e) {
    e.printStackTrace();
}

2.重写onShowFileChooser方法

创建一个类CustomWebViewChrome,继承WebChromeClient,重写其的onShowFileChooser()方法,为了方便说明,下面只给出部分代码:

@Override
public boolean onShowFileChooser(WebView webView, ValueCallback filePathCallback, FileChooserParams fileChooserParams) {
    this.filePathCallback = filePathCallback;
    //姜前端H5接收的格式类型转为字符串,且后面不带分号
    String[] acceptTypes = fileChooserParams.getAcceptTypes();
    String acceptType = "*/*";
    StringBuilder sb = new StringBuilder();
    if (acceptTypes.length > 0) {
        for (String type : acceptTypes) {
            sb.append(type).append(';');
        }
    }
    if (sb.length() > 0) {
        String typeStr = sb.toString();
        acceptType = typeStr.substring(0, typeStr.length() - 1);
    }

    //根据判断，触发相关的操作,如文件选择,拍照等...详见3步讲解
    //这里，也可以实现弹出个对话框供用户选择，记得在弹出对话框之后调用下回调onReceiveValue方法，否则会出现下次无法弹出对话框的Bug
    
    return true;
}

这里,需要说明的是,这个回调这是在点击前端H5的上传组件(即input标签设置type属性为file)即可触发,但是,我们需要调用filePathCallback.onReceiveValue()方法才能把文件给回前端

但文件的参数我们应该怎么获取,且调用上述所说方法?

目前的思路是:

CustomWebViewChrome类中创建个变量,存放filePathCallback这个参数

触发文件选择等操作后面都会回调对应Activity中的onActivityResult()方法,在onActivityResult()方法中处理文件,得到文件对应的Uri

之后就是可以利用我们CustomWebViewChrome对象中的filePathCallback,进行文件的回调操作,将文件Uri传给前端H5

3.Activity获得Uri并回调

上述代码中,我特地空了一段代码,这里以图片选择为例,使用Intent跳转到选择图片的页面

Intent intent = new Intent(Intent.ACTION_PICK, null);
intent.setDataAndType(MediaStore.Images.Media.EXTERNAL_CONTENT_URI, "image/*");
currentActivity.startActivityForResult(intent,15);

跳转页面都是需要Context参数,但CustomWebViewChrome里面没有,所以得加个变量,在创建对象的时候将当前的Activity传进来(当然,我自己这边是传了个Webview对象,也可以获得对应的activity对象)

跳转页面后传有个15(即requestCode),之后得在onActivityResult判断requestCode是否为15,从而对返回的数据进行处理,得到文件的Uri,再回调

public class WebViewActivity extends AppCompatActivity {

    CustomWebViewChrome customWebViewChrome;
    
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        //省略对应的webview设置
      
        WebView webview = findViewById(R.id.webview);
        CustomWebViewChrome customWebViewChrome = new CustomWebViewChrome(webview);
        webview.setWebChromeClient(customWebViewChrome);
        
        String url = "https://stars-one.site";
        customWebView.loadUrl(url);
    }

    @Override
    protected void onActivityResult(int requestCode, int resultCode, @Nullable Intent data) {
        if (requestCode == 15 ) {
            if(resultCode==Activity.RESULT_OK)[
                Uri imgUri = data.getData();
                filePathCallback.onReceiveValue(imgUri);
            ]else{
               filePathCallback.onReceiveValue(new Uri[]{});
            }
        }
    }
}

当然这里你也可以选择使用第三库来实现文件选择,个人推荐的这个库LuckSiege/PictureSelector: 图片选择器,可以拍照和录制视频,且可以多选图片或视频文件,录音文件也支持选择(但是无法录音),而且也封装有权限的动态申请,比较方便,且代码也比较优雅

原理也是一样的,只要按照开源库的文档说明,先拿到文件Uri,之后回调filePathCallback.onReceiveValue()即可

如果是自己要实现,则是有些麻烦,不过下面我也是研究了下拍照和录制视频如何使用Intent方式跳转,简单的补充说明下,仅供参考

补充-Intent跳转页面

下面的例子中,省略了回调filePathCallback.onReceiveValue()代码!!!和上面的保持一致即可!!

录制视频

Intent takeVideoIntent = new Intent(MediaStore.ACTION_VIDEO_CAPTURE);
//takeVideoIntent.putExtra(MediaStore.EXTRA_SIZE_LIMIT,10*1024*1024);//限制10M
takeVideoIntent.putExtra(MediaStore.EXTRA_DURATION_LIMIT, 10);//限制录制时长
if (takeVideoIntent.resolveActivity(activity.getPackageManager()) != null) {
    activity.startActivityForResult(takeVideoIntent, 16);
}

onActivityResult回调文件处理

Uri videoUri = data.getData();
//省略回调

拍照

拍照的话,得先定义好文件的输出路径,但需要注意的是,之后在onActivityResult()方法回调中的data不会携带任何数据

所以在跳转页面前得把文件输出路径先保存一份,之后再onActivityResult,再拿之前的保存的数据回调即可

String acceptType = fileChooserParams.getAcceptTypes()[0];
File file = new File(getExternalFilesDir(Environment.DIRECTORY_PICTURES), "imageCapture+" + System.currentTimeMillis() + ".jpg");
//这个变量是存放在当前的Activity中
captureUri = AppUtils.getPathUri(MainActivity.this, file.getPath());
Intent intent = new Intent(MediaStore.ACTION_IMAGE_CAPTURE);
intent.putExtra(MediaStore.EXTRA_OUTPUT, captureUri);
intent.addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION);
startActivityForResult(intent, CATURE_REQUEST);

public static Uri getPathUri(Context context, String filePath) {
    Uri uri;
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N) {
        String packageName = context.getPackageName();
        uri = FileProvider.getUriForFile(context, packageName + ".fileprovider", new File(filePath));
    } else {
        uri = Uri.fromFile(new File(filePath));
    }
    return uri;
}

文件选择

Intent intent = new Intent(Intent.ACTION_GET_CONTENT);
intent.setType("file/*");
startActivityForResult(intent, requestCode);

onActivityResult()回调中也是通过data.getData()来获得选中文件的Uri

录音

本来录音也可以通过intent跳转的，但实际上手机提示打不开的问题，提示如下：

No Activity found to handle Intent { act=android.provider.MediaStore.RECORD_SOUND }

所以目前解决方案考虑的是直接使用H5进行录音，Android这边则是需要动态申请录音权限即可

使用的开源库框架：xiangyuecn/Recorder

研究使用其的提供的apk安装测试(也是webview套h5),可以正常申请权限并录音

但实际项目中,弹出的权限申请后,允许权限,但是h5还是拿不到权限导致无法录音,需要第二次重新进APP才可以正常录音,原因不明...

研究无果,只好在进入APP前进行录音权限的申请,而不是每次点击开始录音才申请权限

录音Vue代码

首先,安装依赖 "recorder-core": "^1.1.21021500",写在package.json文件中

引入官方提供的MP3播放的js,JS下载地址

之后在Vue文件中需要引入

import Recorder from 'recorder-core'

//需要使用到的音频格式编码引擎的js文件统统加载进来
import 'recorder-core/src/engine/mp3'
import 'recorder-core/src/engine/mp3-engine'

页面按顺序点击按钮即可测试录音功能,可以根据情况改造逻辑,只要记住,每次录音前必须要申请一次录音权限

下面的代码是Uni-App的实现方式,注释上也补充有Vue原生的使用方法,两者不同是,Vue原生得使用audio标签来播放录音,而Uni-App可以通过代码的方式进行创建