Project Icon

AutoplayVideos

Android视频列表自动播放库

AutoplayVideos是一个用于实现视频列表的Android开源库。该库通过解决滚动闪烁、视频加载卡顿和内存溢出等问题,优化了视频列表的性能。主要功能包括视频自动播放/暂停、静音控制、仅播放首个可见视频等。AutoplayVideos还支持将视频下载到本地以提升加载速度,有效简化了视频列表的开发,提高了应用的用户体验。

AutoplayVideos

API Android Arsenal Android Weekly AndroidDev Digest

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

GitHub stars GitHub forks GitHub watchers GitHub followers
Twitter Follow

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

它旨在解决以下问题:

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

并具有以下特性:

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

演示

autoplayvideos_demo

下载

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` 中:

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

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

  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

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

项目侧边栏1项目侧边栏2
推荐项目
Project Cover

豆包MarsCode

豆包 MarsCode 是一款革命性的编程助手,通过AI技术提供代码补全、单测生成、代码解释和智能问答等功能,支持100+编程语言,与主流编辑器无缝集成,显著提升开发效率和代码质量。

Project Cover

AI写歌

Suno AI是一个革命性的AI音乐创作平台,能在短短30秒内帮助用户创作出一首完整的歌曲。无论是寻找创作灵感还是需要快速制作音乐,Suno AI都是音乐爱好者和专业人士的理想选择。

Project Cover

有言AI

有言平台提供一站式AIGC视频创作解决方案,通过智能技术简化视频制作流程。无论是企业宣传还是个人分享,有言都能帮助用户快速、轻松地制作出专业级别的视频内容。

Project Cover

Kimi

Kimi AI助手提供多语言对话支持,能够阅读和理解用户上传的文件内容,解析网页信息,并结合搜索结果为用户提供详尽的答案。无论是日常咨询还是专业问题,Kimi都能以友好、专业的方式提供帮助。

Project Cover

阿里绘蛙

绘蛙是阿里巴巴集团推出的革命性AI电商营销平台。利用尖端人工智能技术,为商家提供一键生成商品图和营销文案的服务,显著提升内容创作效率和营销效果。适用于淘宝、天猫等电商平台,让商品第一时间被种草。

Project Cover

吐司

探索Tensor.Art平台的独特AI模型,免费访问各种图像生成与AI训练工具,从Stable Diffusion等基础模型开始,轻松实现创新图像生成。体验前沿的AI技术,推动个人和企业的创新发展。

Project Cover

SubCat字幕猫

SubCat字幕猫APP是一款创新的视频播放器,它将改变您观看视频的方式!SubCat结合了先进的人工智能技术,为您提供即时视频字幕翻译,无论是本地视频还是网络流媒体,让您轻松享受各种语言的内容。

Project Cover

美间AI

美间AI创意设计平台,利用前沿AI技术,为设计师和营销人员提供一站式设计解决方案。从智能海报到3D效果图,再到文案生成,美间让创意设计更简单、更高效。

Project Cover

AIWritePaper论文写作

AIWritePaper论文写作是一站式AI论文写作辅助工具,简化了选题、文献检索至论文撰写的整个过程。通过简单设定,平台可快速生成高质量论文大纲和全文,配合图表、参考文献等一应俱全,同时提供开题报告和答辩PPT等增值服务,保障数据安全,有效提升写作效率和论文质量。

投诉举报邮箱: service@vectorlightyear.com
@2024 懂AI·鲁ICP备2024100362号-6·鲁公网安备37021002001498号