Android VR Player（全景视频播放器） [6]：视频列表的实现-本地视频

Android VR Player（全景视频播放器） [6]：视频列表的实现-本地视频

(本篇博客参考《Android第一行代码（第二版）》中关于RecyclerView的部分)

列表的实现方式

列表一般使用Listview来实现，但是Listview使用时需要做一些技巧性的优化，否者性能会很差，而且Listview扩展性不太好，所以我们可以使用Android提供的更强大的滚动控件，RecyclerView，来实现视频列表。本篇博客先分享本地视频列表的实现，下篇博客将分享如何实现网络视频列表。

---

RecyclerView实现本地视频列表

添加依赖

新建项目，然后和前面使用bottomnavigationbar一样，在项目app的build.gradle文件的dependencies {}闭包中添加相应的依赖：

compile 'com.android.support:recyclerview-v7:25.3.1'

不要添加到项目的build.gradle文件中了。我发现Android Studio新建项目后的视图是“Android”，开发时，我们一般使用“Project”，会让我们对整个工程的目录结构看得比较清晰。如下图所示：

点击下拉菜单，选择“Project”。

---

准备VideoItem和VideoItemAdapter

可以不那么准确的理解，视频列表就是一个数组，这个数组里面有很多元素，每个元素就是一个VideoItem类的实例。VideoItem类包含一个视频列表项的基本信息，比如视频截图，视频长度，视频名字等等，一个不完整的示例如下：

public class VideoItem {
    public String name;
    public String path;
    public Bitmap thumb;
    public String createdTime;
    public String duration;
    VideoItem(String strPath, String strName, String strCreatedTime,String strDuration,Bitmap thumb) {
        this.path = strPath;
        this.name = strName;
        this.createdTime = strCreatedTime;
        this.duration = strDuration;
        this.thumb = thumb;
    }
    ...
     public String getName() {
        return name;
    }

    public Bitmap getThumb() {
        return thumb;
    }
    .....

上面的类很简单，包含视频的名字，路径等属性，我们提供一个带参数的构造方法，当然，我们还需要提供相关的Getter和Setter方法。在Android Studio中，使用Alt+Insert来自动生成一些方法，比如Getter和Setter，Override方法等等。具体应用时，还需要考虑一些具体的情况，增加一些属性和其他的一些必要的方法。

现在我们已经有了“数组元素”，下一步就是把这些元素添加到一个List中，有了这个List，下一步就是如何展示这个List。但是，没法直接在RecyclerView和ListView这样的View中展示一个List，所以，我们还需要一个适配器，VideoItemAdapter。

到这里，我们需要理一下思路，VideoItem构成的VideoItemList，准备好了要展示数据，这是数据处理阶段；VideoItemAdapter负责把VideoItemList中的数据加载到RecyclerView中，这是View处理阶段。既然涉及到View，自然要有相关的布局。这里需要的是VideoItem的布局。这里需要一点类比的思想，VideoItemList包含很多数据子项，它们是一些VideoItem；而RecyclerView包含很多View子项，它们是一些ViewItem的view。怎么把数据展示到View中，这就是VideoItemAdapter的工作。

一个简单的videoItem的布局可以是：

<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:paddingTop="5dp"
    android:orientation="vertical">

    <ImageView
        android:id="@+id/video_thumb"
        android:layout_alignParentLeft="true"
        android:layout_marginLeft="15dp"
        android:layout_width="120dp"
        android:layout_height="90dp"
        android:scaleType="fitXY"
        android:src="@mipmap/ic_launcher"/>

    <TextView
        android:id="@+id/video_title"
        android:layout_toRightOf="@+id/video_thumb"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="this is titile"
        android:textSize="16sp"
        android:layout_marginLeft="12dp"
        />
    <TextView
        android:id="@+id/video_date"
        android:layout_below="@+id/video_title"
        android:layout_toRightOf="@+id/video_thumb"
        android:layout_marginBottom="5dp"
        android:layout_marginLeft="12dp"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="video size"
        android:textSize="12sp"
        />
    <TextView
        android:id="@+id/video_duration"
        android:layout_below="@+id/video_title"
        android:layout_alignParentRight="true"
        android:layout_marginRight="15dp"
        android:layout_marginBottom="5dp"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="video time last"
        android:textSize="12sp"
        />

RelativeLayout>

它的显示效果为：

---

VideoItemAdapter继承自RecyclerView.Adapter,并且指定泛型为VideoItemAdapter.ViewHolder，ViewHolder是在VideoItemAdapter中定义的内部类。ViewHolder的构造函数需要传入一个View，这个View就是我们的RecyclerView包含的View子项的布局。VideoItemAdapter的完整代码如下：

package com.example.renkangchen.testlist;
import android.content.Context;
import android.graphics.Bitmap;
import android.graphics.BitmapFactory;
import android.support.v7.widget.RecyclerView;
import android.view.LayoutInflater;
import android.view.View;
import android.view.ViewGroup;
import android.widget.ArrayAdapter;
import android.widget.ImageView;
import android.widget.TextView;
import android.widget.Toast;

import java.io.BufferedInputStream;
import java.io.IOException;
import java.io.InputStream;
import java.net.HttpURLConnection;
import java.net.MalformedURLException;
import java.net.URL;
import java.util.List;
/**
 * Created by renkangchen on 17-6-2.
 */
public class VideoItemAdapter extends RecyclerView.Adapter.ViewHolder>{
    private List mVideoList;
    static class ViewHolder extends RecyclerView.ViewHolder{
        View videoListView;

        TextView textView_title;
        TextView textView_createTime;
        TextView textView_duration;
        ImageView thumb;

        public ViewHolder(View view){
            super(view);
            videoListView = view;
            textView_title = (TextView)view.findViewById(R.id.video_title);
            textView_createTime = (TextView)view.findViewById(R.id.video_date);
            textView_duration = (TextView)view.findViewById(R.id.video_duration);
            thumb = (ImageView)view.findViewById(R.id.video_thumb);
        }
    }

    public VideoItemAdapter(List videoList){
        mVideoList = videoList;
    }

    @Override
    public ViewHolder onCreateViewHolder(ViewGroup parent, int viewType) {
        View view = LayoutInflater.from(parent.getContext()).inflate(R.layout.video_item,parent,false);
        final ViewHolder holder = new ViewHolder(view);
        holder.videoListView.setOnClickListener(new View.OnClickListener(){
            @Override
            public void onClick(View v) {
                int position = holder.getAdapterPosition();
                VideoItem videoItem = mVideoList.get(position);
                Toast.makeText(v.getContext(),"click on"+videoItem.getName(),Toast.LENGTH_SHORT).show();
            }
        });
        holder.thumb.setOnClickListener(new View.OnClickListener(){
            @Override
            public void onClick(View v) {
                int position = holder.getAdapterPosition();
                VideoItem videoItem = mVideoList.get(position);
                Toast.makeText(v.getContext(),"click on image "+videoItem.getName(),Toast.LENGTH_SHORT).show();
            }
        });
        return holder;
    }

    @Override
    public void onBindViewHolder(ViewHolder holder, int position) {
        VideoItem videoItem = mVideoList.get(position);
        holder.textView_title.setText(videoItem.getName());
        holder.textView_createTime.setText(videoItem.getCreatedTime());
        holder.textView_duration.setText(videoItem.getStrDuration());
        holder.thumb.setImageBitmap(videoItem.getThumb());
    }

    @Override
    public int getItemCount() {
        return mVideoList.size();
    }

}

看代码应该会更清楚些。我们用ViewHolder来得到一个videoItem的布局；VideoItemAdapter的构造方法用来传入要展示的数据； onCreateViewHolder方法用来创建ViewHolder的实例；onBindViewHolder方法会在一个RecyclerView的子项被滚动到屏幕范围内时调用，它用来给RecyclerView的子项赋值；getItemCount返回RecyclerView的子项数目。需要注意的是，我们必须 重写onCreateViewHolder，onBindViewHolder，getItemCount这三个方法。到这里，我们应该更明白这个VideoItemAdapter的作用了。

另外，我们在onCreateViewHolder的方法中添加了Recyclerview的点击监听。代码应该比较容易理解，不过需要注意的是，不同于ListView只能为Recyclerview子项整体添加，我们可以分别为Recyclerview子项的不同部分添加监听，这也是Recyclerview的优势所在。

用过ListView的同学应该有感觉，就是虽然两种方法的Adapter代码量差不多，但明显，Recyclerview的Adapter更容易理解些。而且不用自己去做一些优化工作，使用起来相对比较容易。

---

AsyncTask异步任务读取本地视频信息

之前的部分已经准备好了“碗筷”，现在就等“上菜”了。这里的“菜”便是我们从手机存储空间（这里不使用内存这样的概念是为了防止混淆）中读取到的视频信息。之前的博客中分享过，为了避免ANR，像读取存储空间，访问网络资源这样比较耗时的操作，都不能放主线程中，而应该开辟子线程去完成。但是多线程的使用并不是一件轻松的事情，因此，Android提供了AsyncTask类来方便我们更加轻松地完成在子线程中进行UI的更新工作。

AsyncTask类包含doInBackground，onProgressUpdate，onPostExecute等几个方法，使用时，我们把需要异步执行的任务放在doInBackground中，onProgressUpdate在异步任务更新时调用，用来动态更新UI，onPostExecute在异步任务结束时调用。AsyncTask类虽然已经帮我们简化了很多的工作，但是要用好AsyncTask也不是一件容易，有特别多需要注意的地方，有兴趣的同学可以自己搜索一下相关资料，或者看一下参考链接中的资料。

这里主要分享一下如何在doInBackground中扫描本地的视频信息。

private class VideoUpdateTask  extends AsyncTask<Void, VideoItem, Void> {
        List mDataList = new ArrayList();
        ....
 }

首先我们创建一个VideoUpdateTask，它继承自AsyncTask，继承时，我们可以指定三个泛型参数，

参数	含义
Params	执行AsyncTask需要传入的参数，用于后台任务
Progress	后台任务执行过程中，使用这里指定的类型作为进度的单位，用于在界面上显示进度
Result	任务执行完毕时，使用这里指定的类型作为结果返回类型

于是我们可以这样定义

private class VideoUpdateTask  extends AsyncTask<Void, VideoItem, Void> 

Params参数指定为Void，表示我们不需要向后台任务传入什么参数；Progress参数指定为VideoItem，表示更新的单位为一个VideoItem；Result参数指定为Void，表示后台任务结束后，我们不需要返回什么结果。

需要注意的是，声明VideoUpdateTask时，需要使用

private AsyncTask<Void, VideoItem, Void> mVideoUpdateTask;

而不是

private AsyncTask mVideoUpdateTask;

或者直接声明成

private VideoUpdateTask mVideoUpdateTask;

这涉及到多态的一些知识，这里不作展开。
在 doInBackground(Void… params)的参数为Void类型的可变参数，如果你指定的Params为String，那么就应该写成 doInBackground(String… params)。

 @Override
        protected Void doInBackground(Void... params) {
            Uri uri = MediaStore.Video.Media.EXTERNAL_CONTENT_URI;
            String[] searchKey = new String[] {
                    MediaStore.Video.Media.TITLE,
                    MediaStore.Images.Media.DATA,
                    MediaStore.Images.Media.DATE_ADDED,
                    MediaStore.Video.Media.DURATION
            };
            String where = null;//scan all video in the media store
            String [] keywords = null;
            String sortOrder = MediaStore.Video.Media.DEFAULT_SORT_ORDER;

            ContentResolver resolver = getContentResolver();
            Cursor cursor = resolver.query(uri, searchKey, where, keywords, sortOrder);

            if(cursor != null)
            {
                while(cursor.moveToNext() && ! isCancelled())
                {
                    String path = cursor.getString(cursor.getColumnIndexOrThrow(MediaStore.Images.Media.DATA));

                    String name = cursor.getString(cursor.getColumnIndex(MediaStore.Video.Media.TITLE));
                    String createdTime = cursor.getString(cursor.getColumnIndexOrThrow(MediaStore.Images.Media.DATE_ADDED));
                    Long duration = cursor.getLong(cursor.getColumnIndexOrThrow(MediaStore.Video.Media.DURATION));
                    int duration2second = (int)(duration/1000);
                    Bitmap thumb = ThumbnailUtils.createVideoThumbnail(path, MediaStore.Images.Thumbnails.MINI_KIND);

                    VideoItem data = new VideoItem(path, name, createdTime,duration2second,thumb);
                    Log.d(TAG, "doInBackground: video item ==== "+data.getName());
                    publishProgress(data);
                    mDataList.add(data);
                }
                cursor.close();
            }
            return null;
        }

这里的“扫描”其实准确地讲是从系统提供的媒体库中读取视频相关的数据，媒体库为我们提供了相应的内容提供器作为访问接口。内容提供器作为Android四大组件（内容提供器，活动，服务，广播接收器）之一，无疑是十分重要的知识，通过这个例子我们便可以了解内容提供器的用法，不过暂时我们不需要写自己的内容提供器，而是先试着用其他应用提供的内容提供器。要访问内容提供器的内容，就一定要使用ContextResolver：

  ContentResolver resolver = getContentResolver();

通过getContentResolver()来获取ContentResolver的一个实例。ContentResolver为我们提供了一系列的方法来进行增删查改操作（CRUD：Create，Retrieve，Update，Delete）。这里我们需要的方法为query，即查询系统媒体库中的视频信息。

 Cursor cursor = resolver.query(uri, searchKey, where, keywords, sortOrder);

query需要的几个参数为：

参数	含义
uri	指定查询的表名
projection	指定查询的列名
selection	指定where的约束条件
selectionArgs	指定为where中的占位符提供具体的值
orderBy	指定查询结果的排序方式

Uri uri = MediaStore.Video.Media.EXTERNAL_CONTENT_URI;
String[] searchKey = new String[] {
      MediaStore.Video.Media.TITLE,
      MediaStore.Images.Media.DATA,
      MediaStore.Images.Media.DATE_ADDED,
      MediaStore.Video.Media.DURATION
      };
String where = null;//scan all video in the media store
String [] keywords = null;
String sortOrder = MediaStore.Video.Media.DEFAULT_SORT_ORDER;

uri我们直接使用MediaStore.Video.Media.EXTERNAL_CONTENT_URI，其中EXTERNAL_CONTENT_URI常量是一个Uri.parse()解析后的结果，所以直接使用就可以了；searchKey 中我们指定需要查询的列是TITLE，DATA，DATE_ADDED等几列；where条件指定为null，表示查询媒体库所有的视频，当然也可以指定查询特定路劲下的视频，可以用这样的方式

String where = MediaStore.Video.Media.DATA + " like \"%"+getString(R.string.search_path)+"%\"";

来查询特定路径下的视频；keywords同样设为null；sortOrder使用默认排序方式就好了。

查询的结果返回一个Cursor类型对象，Cursor翻译为光标或者是游标，在Android中，它是每行的集合。得到了返回的cursor，我们就可以把视频信息从cursor中逐个读取出来了

 if(cursor != null) {
                while(cursor.moveToNext() && ! isCancelled()){
                    String path = cursor.getString(cursor.getColumnIndexOrThrow(MediaStore.Images.Media.DATA));
                    String name = cursor.getString(cursor.getColumnIndex(MediaStore.Video.Media.TITLE));
                    String createdTime = cursor.getString(cursor.getColumnIndexOrThrow(MediaStore.Images.Media.DATE_ADDED));
                    Long duration = cursor.getLong(cursor.getColumnIndexOrThrow(MediaStore.Video.Media.DURATION));
                    int duration2second = (int)(duration/1000);
                    Bitmap thumb = ThumbnailUtils.createVideoThumbnail(path, MediaStore.Images.Thumbnails.MINI_KIND);
                    VideoItem data = new VideoItem(path, name, createdTime,duration2second,thumb);
                    Log.d(TAG, "doInBackground: video item ==== "+data.getName());
                    publishProgress(data);
                    mDataList.add(data);
    }
    cursor.close();
}

读取的方法就是通过移动moveToNext()游标的位置来遍历返回的Cursor对象中的所有行，然后在取出每一行中对应列的数据。需要注意最后的close操作，不要忘记了这个。有过关系数据库使用经历的同学会比较容易理解上面这些操作。注意到每次读取完一行数据后我们都使用了

publishProgress(data);
//publishProgress源码
  @WorkerThread
    protected final void publishProgress(Progress... values) {
        if (!isCancelled()) {
            getHandler().obtainMessage(MESSAGE_POST_PROGRESS,
                    new AsyncTaskResult(this, values)).sendToTarget();
        }
    }

publishProgress方法用来发送UI更新消息，它被调用后，onProgressUpdate很快会被调用，不可以在 doInBackground中调用onProgressUpdate方法，涉及到UI更新的操作都不可放在 doInBackground。onProgressUpdate可以是：

 @Override
        protected void onProgressUpdate(VideoItem... values) {
            VideoItem data = values[0];
            mVideoList.add(data);
            mVideoItemAdapter.notifyDataSetChanged();
        }

VideoItem 就是我们声明AsyncTask时，指定的三个泛型

在MainAcivity中使用RecyclerView

要在在MainAcivity中使用RecyclerView，当然先要在MainAcivity的布局中添加这个view:

<FrameLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    tools:context="com.example.renkangchen.testlist.MainActivity">

     <android.support.v7.widget.RecyclerView
        android:id="@+id/recyclerView"
        android:layout_width="match_parent"
        android:layout_height="match_parent">
    android.support.v7.widget.RecyclerView>

FrameLayout>

RecyclerView的使用没有太大的差别

private LinearLayoutManager mLinearLayoutManager;

在onCreate中

mRecyclerView = (RecyclerView)findViewById(R.id.recyclerView);

另外mRecyclerView还需要用setLayoutManager方法来设置布局管理器（这个是必需的，比如你想横着显示列表，而不是竖着，比如你想要瀑布效果，都可以通过指定布局管理器来实现）；用setAdapter方法来设置Adapter（这个也是必需的）；用setItemAnimator来设置添加和移除的动画（这个是非必需的）；用addItemDecoration来设置分割线的（这个也是非必需的，可以定制自己的分割线样式，而不是像Listview那样只能用默认的）。之前说过RecyclerView十分强大，意味着它是更自由的，所以和Listview比起来它似乎是更复杂了些，但这种“复杂”也让我们可以实现更多的定制的效果。

这里我们就简单些，只使用两个必要的方法，把RecyclerView的布局管理器指定为LinearLayoutManager，Adapter当然就是我们之前写的VideoItemAdapter了。

然后用异步任务VideoUpdateTask来”扫描“本地媒体库信息，并进行UI更新。需要注意的是，读取媒体库是几组敏感操作中的一个，所以必须要要进行权限申请，6.0以后需要动态申请权限，而不是直接在AndroidManifest中申请就可以了。

 if(Build.VERSION.SDK_INT >= 23) {
            if ((ContextCompat.checkSelfPermission(MainActivity.this, Manifest.permission.WRITE_EXTERNAL_STORAGE) !=
                    PackageManager.PERMISSION_GRANTED) && (ContextCompat.checkSelfPermission(MainActivity.this,         Manifest.permission.READ_EXTERNAL_STORAGE) !=
                    PackageManager.PERMISSION_GRANTED)) {
                //get the permission
                ActivityCompat.requestPermissions(MainActivity.this,new String[]{Manifest.permission.WRITE_EXTERNAL_STORAGE},1);
                ActivityCompat.requestPermissions(MainActivity.this,new String[]{Manifest.permission.READ_EXTERNAL_STORAGE},1);
            }//if without permission
            else{
                updateVideoList();
            }
        }//if higher sdk 23
        else{
            updateVideoList();
        }
...
  @Override
    public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {
        super.onRequestPermissionsResult(requestCode, permissions, grantResults);
        switch (requestCode){
            case 1:
                if(grantResults.length > 0 && grantResults[0] == PackageManager.PERMISSION_GRANTED){
                    updateVideoList();
                }else{
                    Toast.makeText(this,"You denied the Permission",Toast.LENGTH_SHORT).show();
                }break;
            default:
                break;
        }
    }

首先做个判断，6.0以后才需要动态申请，否者直接用AndroidManifest中获得的权限即可。这里申请了两个权限WRITE_EXTERNAL_STORAGE和READ_EXTERNAL_STORAGE，虽然只会用到读权限但读写往往在一起的，还是一起申请了吧。但动态权限机制引入的目的就是为了权限被滥用，所以规范来讲还是应该做到用什么权限就申请什么权限，而不是一来就要申请一大堆权限。onRequestPermissionsResult返回申请的结果，申请成功的话，我们就调用updateVideoList()这个方法：

  public void updateVideoList(){
        mVideoList.clear();
        mVideoUpdateTask = new VideoUpdateTask();
        mVideoUpdateTask.execute();
    }

它先清除mVideoList中的数据，然后新建一个VideoUpdateTask，并使用execute()方法来执行这个异步任务。

如果用户拒绝了权限申请，我们需要进行相应的操作反馈。如果是6.0以前的系统，那就直接调用updateVideoList()就好了。

---

结果

build工程，然后运行：

提示请求权限，这里我们选择同意。

可以看到，成功地读取了本地的视频文件（这里本地只有一个视频，为了展示列表的效果，就复制了几次，几个视频只是名字不同）。

点击其中一个视频列表项，触发点击事件，

点击其中一个视频列表项的视频缩略图，，触发另外一个点击事件。

总结一下，本篇博文涉及的内容较多，自己也感觉不论ListView还是RecyclerView都是Android众多控件中最常用也是最复杂难用的。时间比较紧张，写得很粗糙，疏漏错误之处，还请大家指正。下面是自己做此部分时阅读的一些参考资料。

---

Reference

手把手教你做视频播放器（三）－展示视频列表
第4章 展示视频列表
Android RecyclerView 使用完全解析 体验艺术般的控件
深入理解AsyncTask的工作原理
解读ContentResolver和ContentProvider
Android 中关于 【Cursor】 类的介绍
Android四大基本组件介绍与生命周期
Requesting Permissions(自备梯子)
Java多态性理解
Java Object类

---

参考源码

因为写博客时为了方便说明，会去掉一部分代码，所以建议下载完整的工程源码：
链接: https://pan.baidu.com/s/1boUg5P1 密码: h4rf