Android调用文件管理器选取视频播放功能实现

发布于 / 程序猿 / 2 条评论

这是《移动应用开发平台》课程的一次课后作业,还是很有实用价值的,代码实现参考了《第一行代码——Android(第2版)》和博客ANDROID中调用文件管理器并返回选中文件的路径


思路

整个过程就是调用文件管理器选择文件然后得到Uri,再解析Uri得到文件绝对路径,最后调用videoView输出。关键部分就在于如何解析Uri得到文件真实路径


效果

首先,我们先看一下实际效果演示。

由于GIF动图过大,更完整的功能演示可以点击链接查看。


代码

我们先说一下布局内容,然后再来说具体功能实现。注意不要忘了在AndroidManifest.xml声明读写文件权限,代码为<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />

  • 布局文件

线性布局:由四个Button按钮和一个VideoView视频控件组成。

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:orientation="vertical"
    android:layout_width="match_parent"
    android:layout_height="match_parent" >
    <LinearLayout
        android:layout_width="match_parent"
        android:layout_height="wrap_content" >
        <Button
            android:id="@+id/play"
            android:layout_width="0dp"
            android:layout_height="wrap_content"
            android:layout_weight="1"
            android:text="Play" />
        <Button
            android:id="@+id/pause"
            android:layout_width="0dp"
            android:layout_height="wrap_content"
            android:layout_weight="1"
            android:text="Pause" />
        <Button
            android:id="@+id/replay"
            android:layout_width="0dp"
            android:layout_height="wrap_content"
            android:layout_weight="1"
            android:text="Replay" />

    </LinearLayout>

    <LinearLayout
        android:layout_width="match_parent"
        android:layout_height="wrap_content" >
        <Button
            android:id="@+id/choose_vedio"
            android:layout_width="match_parent"
            android:layout_height="wrap_content"
            android:text="Choose Vedio" />
    </LinearLayout>

    <VideoView
        android:id="@+id/video_view"
        android:layout_width="match_parent"
        android:layout_height="wrap_content" />
</LinearLayout>
  • 主活动

书上的代码是实现指定SD卡根目录下文件名为movie.mp4的视频播放。

首先在onCreate() 方法中同样进行了一个运行时权限处理, 因为视频文件将会放在SD卡上。 当用
户同意授权了之后就会调用initVideoPath() 方法来设置视频文件的路径, 这里我们需要事
先在SD卡的根目录下放置一个名为movie.mp4的视频文件。
下面看一下各个按钮的点击事件中的代码。 当点击Play按钮时会进行判断, 如果当前并没有正在
播放视频, 则调用start() 方法开始播放。 当点击Pause按钮时会判断, 如果当前视频正在播
放, 则调用pause() 方法暂停播放。 当点击Replay按钮时会判断, 如果当前视频正在播放, 则
调用resume() 方法从头播放视频。
最后在onDestroy() 方法中, 我们还需要调用一下suspend() 方法, 将VideoView所占用的
资源释放掉。

我们需要改动的就是添加内容处理Choose File按钮点击事件:打开文件管理器选取视频以及解析获得的Uri,具体实现见代码。

package com.taifua.playvideotest;

import android.Manifest;
import android.annotation.SuppressLint;
import android.app.Activity;
import android.content.ContentUris;
import android.content.Context;
import android.content.Intent;
import android.content.pm.PackageManager;
import android.database.Cursor;
import android.net.Uri;
import android.os.Build;
import android.os.Environment;
import android.provider.DocumentsContract;
import android.provider.MediaStore;
import android.support.v4.app.ActivityCompat;
import android.support.v4.content.ContextCompat;
import android.support.v7.app.AppCompatActivity;
import android.os.Bundle;
import android.view.View;
import android.widget.Button;
import android.widget.Toast;
import android.widget.VideoView;
import java.io.File;

public class MainActivity extends AppCompatActivity implements View.OnClickListener
{

    private VideoView videoView;
    private String vedioPath;

    @Override
    protected void onCreate(Bundle savedInstanceState)
    {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        videoView = (VideoView) findViewById(R.id.video_view);
        Button play = (Button) findViewById(R.id.play);
        Button pause = (Button) findViewById(R.id.pause);
        Button replay = (Button) findViewById(R.id.replay);
        Button chooseVedio = (Button) findViewById(R.id.choose_vedio);
        play.setOnClickListener(this); // 播放
        pause.setOnClickListener(this); // 暂停
        replay.setOnClickListener(this); // 重播

        if (ContextCompat.checkSelfPermission(MainActivity.this, Manifest.permission.WRITE_EXTERNAL_STORAGE) != PackageManager.PERMISSION_GRANTED)
        {
            ActivityCompat.requestPermissions(MainActivity.this, new String[]{Manifest.permission.WRITE_EXTERNAL_STORAGE}, 1);
        }
        else
        {
            initVideoPath(); // 初始化MediaPlayer 默认播放
        }

        chooseVedio.setOnClickListener(new View.OnClickListener()
        {
            @Override
            public void onClick(View view)
            {
                Intent intent = new Intent(Intent.ACTION_GET_CONTENT);
                // intent.setType(“image/*”); // 选择图片
                // intent.setType(“audio/*”); // 选择音频
                // intent.setType(“video/*”); // 选择视频 (mp4等android支持的视频格式)
                // intent.setType(“video/*;image/*”); // 同时选择视频和图片
                intent.setType("*/*"); // 无类型限制
                intent.addCategory(Intent.CATEGORY_OPENABLE);
                startActivityForResult(intent, 1);
            }
        });
    }

    protected void onActivityResult(int requestCode, int resultCode, Intent data)
    {
        if (resultCode == Activity.RESULT_OK)
        {
            Uri uri = data.getData();
            // videoView.setVideoURI(uri); // 播放视频可直接调用,无需再单独解析uri
            if ("file".equalsIgnoreCase(uri.getScheme())) // 使用第三方应用打开
            {
                vedioPath = uri.getPath();
                Toast.makeText(this, vedioPath, Toast.LENGTH_SHORT).show();
                return;
            }
            if (Build.VERSION.SDK_INT > Build.VERSION_CODES.KITKAT) // 4.4以后
            {
                vedioPath = getPath(this, uri);
                Toast.makeText(this, vedioPath, Toast.LENGTH_SHORT).show();
            }
            else // 4.4以下系统调用方法
            {
                vedioPath = getRealPathFromURI(uri);
                Toast.makeText(MainActivity.this, vedioPath, Toast.LENGTH_SHORT).show();
            }
            videoView.setVideoPath(vedioPath); // 设置视频路径
        }
    }

    public String getRealPathFromURI(Uri contentUri)
    {
        String res = null;
        String[] proj = {MediaStore.Images.Media.DATA};
        Cursor cursor = getContentResolver().query(contentUri, proj, null, null, null);
        if (null != cursor && cursor.moveToFirst())
        {
            int column_index = cursor.getColumnIndexOrThrow(MediaStore.Images.Media.DATA);
            res = cursor.getString(column_index);
            cursor.close();
        }
        return res;
    }

    /**
     * 专为Android4.4设计的从Uri获取文件绝对路径,以前的方法已不好使
     */
    @SuppressLint("NewApi")
    public String getPath(final Context context, final Uri uri)
    {
        final boolean isKitKat = Build.VERSION.SDK_INT >= Build.VERSION_CODES.KITKAT;

        // DocumentProvider
        if (isKitKat && DocumentsContract.isDocumentUri(context, uri))
        {
            // ExternalStorageProvider
            if (isExternalStorageDocument(uri))
            {
                final String docId = DocumentsContract.getDocumentId(uri);
                final String[] split = docId.split(":");
                final String type = split[0];

                if ("primary".equalsIgnoreCase(type))
                {
                    return Environment.getExternalStorageDirectory() + "/" + split[1];
                }
            }
            // DownloadsProvider
            else if (isDownloadsDocument(uri))
            {

                final String id = DocumentsContract.getDocumentId(uri);
                final Uri contentUri = ContentUris.withAppendedId(Uri.parse("content://downloads/public_downloads"), Long.valueOf(id));

                return getDataColumn(context, contentUri, null, null);
            }
            // MediaProvider
            else if (isMediaDocument(uri))
            {
                final String docId = DocumentsContract.getDocumentId(uri);
                final String[] split = docId.split(":");
                final String type = split[0];

                Uri contentUri = null;
                if ("image".equals(type))
                {
                    contentUri = MediaStore.Images.Media.EXTERNAL_CONTENT_URI;
                }
                else if ("video".equals(type))
                {
                    contentUri = MediaStore.Video.Media.EXTERNAL_CONTENT_URI;
                }
                else if ("audio".equals(type))
                {
                    contentUri = MediaStore.Audio.Media.EXTERNAL_CONTENT_URI;
                }

                final String selection = "_id=?";
                final String[] selectionArgs = new String[]{split[1]};

                return getDataColumn(context, contentUri, selection, selectionArgs);
            }
        }
        // MediaStore (and general)
        else if ("content".equalsIgnoreCase(uri.getScheme()))
        {
            return getDataColumn(context, uri, null, null);
        }
        // File
        else if ("file".equalsIgnoreCase(uri.getScheme()))
        {
            return uri.getPath();
        }
        return null;
    }

    /**
     * Get the value of the data column for this Uri. This is useful for
     * MediaStore Uris, and other file-based ContentProviders.
     *
     * @param context       The context.
     * @param uri           The Uri to query.
     * @param selection     (Optional) Filter used in the query.
     * @param selectionArgs (Optional) Selection arguments used in the query.
     * @return The value of the _data column, which is typically a file path.
     */
    public String getDataColumn(Context context, Uri uri, String selection, String[] selectionArgs)
    {

        Cursor cursor = null;
        final String column = "_data";
        final String[] projection = {column};
        try
        {
            cursor = context.getContentResolver().query(uri, projection, selection, selectionArgs, null);
            if (cursor != null && cursor.moveToFirst())
            {
                final int column_index = cursor.getColumnIndexOrThrow(column);
                return cursor.getString(column_index);
            }
        } finally
        {
            if (cursor != null) cursor.close();
        }
        return null;
    }

    /**
     * @param uri The Uri to check.
     * @return Whether the Uri authority is ExternalStorageProvider.
     */
    public boolean isExternalStorageDocument(Uri uri)
    {
        return "com.android.externalstorage.documents".equals(uri.getAuthority());
    }

    /**
     * @param uri The Uri to check.
     * @return Whether the Uri authority is DownloadsProvider.
     */
    public boolean isDownloadsDocument(Uri uri)
    {
        return "com.android.providers.downloads.documents".equals(uri.getAuthority());
    }

    /**
     * @param uri The Uri to check.
     * @return Whether the Uri authority is MediaProvider.
     */
    public boolean isMediaDocument(Uri uri)
    {
        return "com.android.providers.media.documents".equals(uri.getAuthority());
    }

    private void initVideoPath()
    {
        File file = new File(Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_DOWNLOADS), "movie.mp4");
        videoView.setVideoPath(file.getPath()); // 指定视频文件的路径
    }

    @Override
    public void onRequestPermissionsResult(int requestCode, String[] permissions, int[] grantResults)
    {
        switch (requestCode)
        {
            case 1:
                if (grantResults.length > 0 && grantResults[0] == PackageManager.PERMISSION_GRANTED)
                {
                    initVideoPath();
                }
                else
                {
                    Toast.makeText(this, "拒绝权限将无法使用程序", Toast.LENGTH_SHORT).show();
                    finish();
                }
                break;
            default:
        }
    }

    @Override
    public void onClick(View v)
    {
        switch (v.getId())
        {
            case R.id.play:
                if (!videoView.isPlaying())
                {
                    videoView.start(); // 开始播放
                }
                break;
            case R.id.pause:
                if (videoView.isPlaying())
                {
                    videoView.pause(); // 暂停播放
                }
                break;
            case R.id.replay:
                if (videoView.isPlaying())
                {
                    videoView.resume(); // 重新播放
                }
                break;
        }
    }

    @Override
    protected void onDestroy()
    {
        super.onDestroy();
        if (videoView != null)
        {
            videoView.suspend();
        }
    }

}

其实我们可以直接调用videoViewsetVideoURI()方法实现播放视频,无需再单独解析Uri,当然只针对视频有效,所以onActivityResult就只需要:

protected void onActivityResult(int requestCode, int resultCode, Intent data)
{
    if (resultCode == Activity.RESULT_OK)
    {
        Uri uri = data.getData();
        videoView.setVideoURI(uri); // 播放视频可直接调用,无需再单独解析uri
    }
}

后面的Uri解析部分就不需要了,感谢盼盼同学😀。

但是这段解析Uri的代码还是非常有用的,因为我们会处理包括但不限于视频的各种文件。


补充

  • 权限申请说明

说白了, 运行时权限的核心就是在程序运行过程中由用户授权我们去执行某些危险操作, 程序是不可以擅自做主
去执行这些危险操作的。 因此, 第一步就是要先判断用户是不是已经给过我们授权了, 借助的是ContextCompat.checkSelfPermission() 方法。 checkSelfPermission() 方法接收两个参数, 第一个参数是Context,这个没什么好说的, 第二个参数是具体的权限名, 比如写文件的权限名就是Manifest.permission.WRITE_EXTERNAL_STORAGE,然后我们使用方法的返回值和
PackageManager.PERMISSION_GRANTED 做比较,相等就说明用户已经授权, 不等就表示用户没有授权。

  • onActivityResult() 方法

onActivityResult() 方法带有三个参数, 第一个参数requestCode , 即我们在启动活动时传入的请求码。 第二个参数resultCode , 即我们在返回数据时传入的处理结果。 第三个参数data , 即携带着返回数据的Intent。 由于在一个活动中有可能调用startActivityForResult() 方法去启动很多不同的活动, 每一个活动返回的数据都会回调到onActivityResult() 这个方法中, 因此我们首先要做的就是通过检查requestCode的值来判断数据来源。 确定数据是从SecondActivity返回的之后, 我们再通过resultCode 的值来判断处理结果是否成功。 最后从data 中取值并打印出来, 这样就完成了向上一个活动返回数据的工作。


The end.
2018年12月6日 星期四

转载原创文章请注明,转载自: 太傅 » Android调用文件管理器选取视频播放功能实现
  1. 惶心

    看太傅的博文,貌似是在学安卓开发?|´・ω・)ノ

    1. TaiFu_S
      @惶心

      什么都学什么都没学会,课程安排很乱。