AutoplayVideos

请给项目一些:heart:并为其加星以表示支持

这个库的目的是为了方便地在RecyclerView中实现视频功能。

它旨在解决以下问题：

1. 滚动时的闪烁。
2. 视频开始时的卡顿或跳帧。
3. 内存溢出错误。

并具有以下特性：

1. 当视频在视图中时自动播放。
2. 当视频不在视图中或部分在视图中时自动暂停。
3. 视频静音/取消静音。
4. 可选择只播放第一个可见的视频。
5. 将视频下载到本地存储以加快加载速度。

演示

下载

Gradle

第1步. 在项目级build.gradle文件中添加jCenter仓库

allprojects {
	repositories {
		jcenter()
	}
}

第2步. 在应用级build.gradle文件中添加依赖：

dependencies {
	 compile 'com.allattentionhere:autoplayvideos:0.2.0'
}

或Maven

<dependency>
  <groupId>com.allattentionhere</groupId>
  <artifactId>autoplayvideos</artifactId>
  <version>0.2.0</version>
  <type>pom</type>
</dependency>

权限

在AndroidManifest.xml中添加以下权限

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

使用方法

在单个列表项的xml文件single_card.xml中添加AAH_VideoImage：

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:card_view="http://schemas.android.com/apk/res-auto"
    android:layout_width="match_parent"
    android:layout_height="wrap_content">

    <android.support.v7.widget.CardView
        android:id="@+id/card_view"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content">
       
       <LinearLayout
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:orientation="vertical">

             <FrameLayout
                android:layout_width="300dp"
                android:layout_height="150dp">

                <com.allattentionhere.autoplayvideos.AAH_VideoImage
                    android:layout_width="match_parent"
                    android:layout_height="match_parent" />
将 `AAH_CustomRecyclerView` 添加到您的 Activity 布局 xml `MainActivity.xml` 中：

<?xml version="1.0" encoding="utf-8"?>

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" android:layout_width="match_parent" android:layout_height="match_parent" android:orientation="vertical">

<com.allattentionhere.autoplayvideos.AAH_CustomRecyclerView
    android:id="@+id/rv_home"
    android:layout_width="wrap_content"
    android:layout_height="wrap_content" />

</LinearLayout> ```

设置适配器时需要遵循以下要点：

1. 适配器应继承 AAH_VideosAdapter。
2. ViewHolder 应继承 AAH_CustomViewHolder。
3. 在 onBindViewHolder 方法中设置缩略图 URL 和视频 URL。

public class MyVideosAdapter extends AAH_VideosAdapter {

    private List<MyModel> list;
    Picasso picasso;

    public class MyViewHolder extends AAH_CustomViewHolder {
        final TextView tv;
	final ImageView img_vol,img_playback;
        boolean isMuted; //用于视频静音/取消静音（可选）
	
        public MyViewHolder(View x) {
            super(x);
            tv = ButterKnife.findById(x, R.id.tv);
	    img_vol = ButterKnife.findById(x, R.id.img_vol);
	    img_playback = ButterKnife.findById(x, R.id.img_playback);
        }
    }

    public MyVideosAdapter(List<MyModel> list_urls, Picasso p) {
        this.list = list_urls;
        this.picasso = p;
    }

    @Override
    public AAH_CustomViewHolder onCreateViewHolder(ViewGroup parent, int viewType) {
        View itemView = LayoutInflater.from(parent.getContext())
                .inflate(R.layout.single_card, parent, false);
        return new MyViewHolder(itemView);
    }

    @Override
    public void onBindViewHolder(AAH_CustomViewHolder holder, int position) {
        ((MyViewHolder) holder).tv.setText(list.get(position).getName());

        //待办
        holder.setImageUrl(list.get(position).getImage_url());
        holder.setVideoUrl(list.get(position).getVideo_url());
        //将图片/缩略图加载到 ImageView 中
        if (list.get(position).getImage_url() != null && !list.get(position).getImage_url().isEmpty())
            picasso.load(holder.getImageUrl()).config(Bitmap.Config.RGB_565).into(holder.getAAH_ImageView());
    }
    
    @Override
    public int getItemCount() {
        return list.size();
    }

    @Override
    public int getItemViewType(int position) {
        return 0;
    }
}

最后，在设置适配器之前在您的 Activity 中调用 setActivity，并（可选）通过编程方式滚动以启动初始屏幕上的视频：

    recyclerView.setActivity(this); //在 setAdapter 之前调用
    recyclerView.setAdapter(mAdapter);

初始播放视频（可选）

调用这两个函数，在屏幕启动且用户尚未滚动时开始视频播放。

recyclerView.smoothScrollBy(0,1);
recyclerView.smoothScrollBy(0,-1);

只播放第一个视频（可选）

设置此参数将只在第一个完全可见的 RecyclerView ViewHolder 中播放视频。

recyclerView.setPlayOnlyFirstVideo(true); // 默认为 false

将视频下载到本地存储（可选）

您可以在 ViewHolder 加载时开始在后台下载视频。您可以更改下载路径。

recyclerView.setDownloadPath(Environment.getExternalStorageDirectory() + "/MyVideo"); //可选
recyclerView.setDownloadVideos(true); // 默认为 false

您还可以选择通过将 URL 列表传递给函数来开始预下载所有视频，如下所示：

List<String> urls = new ArrayList<>();
 for (MyModel object : modelList) {
     if (object.getVideo_url() != null && object.getVideo_url().endsWith(".mp4"))
         urls.add(object.getVideo_url());
 }
recyclerView.preDownload(urls);

将以下权限添加到 AndroidManifest.xml 中。在 Marshmallow 及以上设备上请求运行时权限。

<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />

取消对 .mp4 的检查（可选）

默认情况下，它会检查 URL 是否以 .mp4 结尾，否则不会被视为视频 URL。您可以通过设置参数来覆盖此行为，如下所示。请谨慎使用此选项，并确保您只提供视频 URL。

recyclerView.setCheckForMp4(false); // 默认为 true

手动暂停视频（可选）

当 Activity/Fragment 停止时（用户接到电话、最小化应用等）调用以下方法来停止视频

    @Override
    protected void onStop() {
        super.onStop();
        recyclerView.stopVideos();
    }

应用恢复时继续播放视频（可选）

当应用恢复时（最小化后重新打开应用等）调用以下方法来恢复视频播放

    @Override
    protected void onResume() {
        super.onResume();
        recyclerView.playAvailableVideos(0);
    }

播放部分可见视频（可选）

调用以下方法设置视频开始播放所需的可见百分比。

    recyclerView.setVisiblePercent(50);

获取视频开始和暂停的回调

您可以重写 AAH_CustomViewHolder 的以下方法，以在视频开始播放或暂停时获得回调。

    @Override
    public void videoStarted() {
        super.videoStarted();
        img_playback.setImageResource(R.drawable.ic_pause);
        if (isMuted) {
            muteVideo();
            img_vol.setImageResource(R.drawable.ic_mute);
        } else {
            unmuteVideo();
            img_vol.setImageResource(R.drawable.ic_unmute);
        }
    }
    @Override
    public void pauseVideo() {
        super.pauseVideo();
        img_playback.setImageResource(R.drawable.ic_play);
    }

手动播放或暂停视频

您可以通过在 onBindViewHolder 中添加以下代码，允许用户播放或暂停任何视频：

    ((MyViewHolder) holder).img_playback.setOnClickListener(new View.OnClickListener() {
        @Override
        public void onClick(View v) {
            if (holder.isPlaying()) {
                holder.pauseVideo();
                holder.setPaused(true);
            } else {
                holder.playVideo();
                holder.setPaused(false);
            }
        }
    });

静音或取消静音视频

通过在 onBindViewHolder 中添加以下代码，可以静音/取消静音视频：

    holder.getAah_vi().setOnClickListener(new View.OnClickListener() {
        @Override
        public void onClick(View v) {
            if (((MyViewHolder) holder).isMuted) {
                holder.unmuteVideo();
                ((MyViewHolder) holder).img_vol.setImageResource(R.drawable.ic_unmute);
            } else {
                holder.muteVideo();
                ((MyViewHolder) holder).img_vol.setImageResource(R.drawable.ic_mute);
            }
            ((MyViewHolder) holder).isMuted = !((MyViewHolder) holder).isMuted;
        }
    });

设置视频循环播放

通过在 onBindViewHolder 中添加以下代码设置视频循环播放：

holder.setLooping(true); //可选 - 默认为true

缓存视频（可选）

建议将 setDownloadVideos(value) 设置为 true。但如果您不想使用此选项，我们推荐您使用 AndroidVideoCache 库。 以下是如何将其与我们的库一起使用：

初始化 HttpProxyCacheServer

在您的 Application 类中初始化 HttpProxyCacheServer，并在 Manifest 文件中注册 Application 类。

public class MyApplication extends Application {
    private static HttpProxyCacheServer proxy;

    public static HttpProxyCacheServer getProxy() {
        return proxy;
    }

    @Override
    public void onCreate() {
        super.onCreate();
        proxy = new HttpProxyCacheServer(this);
    }
}    

设置代理视频 URL

在您的 VideosAdapter 中，按如下方式设置视频 URL：

holder.setVideoUrl(MyApplication.getProxy().getProxyUrl(list.get(position).getVideo_url()+"")); // url 不应为 null

您还可以使用该库支持的高级缓存选项。请参阅他们的文档以获取相关信息。

使用 Cloudinary（可选）

建议使用 Cloudinary.com 托管您的视频，因为它提供了简便的缩略图生成和即时视频调整大小/裁剪功能。

更新日志

• 更新日志

我们的其他库

• FabulousFilter

开发者的其他应用

[Price Stalker] [Show Card Game] [Safio chat] [Dota Picker Pro]

许可证

Copyright 2017 Krupen Ghetiya 根据 Apache 许可证 2.0 版（"许可证"）授权； 除非遵守许可证，否则您不得使用此文件。 您可以在以下网址获取许可证副本：

http://www.apache.org/licenses/LICENSE-2.0

除非适用法律要求或书面同意，否则根据许可证分发的软件是基于"按原样"分发的， 不附带任何明示或暗示的担保或条件。 有关许可证下的特定语言管理权限和限制，请参阅许可证。