FullscreenVideoView 使用教程

FullscreenVideoView An Android Library to replace VideoView with Fullscreen feature 项目地址: https://gitcode.com/gh_mirrors/fu/FullscreenVideoView

1. 项目目录结构及介绍

FullscreenVideoView 是一个旨在增强原生 VideoView 功能的Android库，特别是添加了全屏播放特性。以下是该仓库的基本目录结构及关键文件说明：

- FullscreenVideoView
  ├── doc                 # 文档资料，可能包含API说明或额外开发指南。
  ├── src                 # 源代码目录
    └── main              # 主工程源码
      ├── java             # Java源码文件夹
        └── com.github.rtoshiro.view.video   # 项目主要代码所在包
          ├── FullscreenVideoView.java     # 主类，继承自RelativeLayout，实现视频全屏功能
          └── 其他相关类文件                    # 可能包括自定义布局控件等
      ├── res               # 资源文件夹，包含UI资源如图片、布局文件等
        ├── layout           # 布局文件，例如用于全屏控制的布局
        ├── drawable         # 图标和其他图形资源
        └── ...
  ├── LICENSE             # 许可证文件，表明该项目遵循Apache 2.0协议
  ├── README.md           # 项目简介和快速入门指南
  ├── build.gradle        # Gradle构建脚本
  └── ...                 # 其它Gradle和版本管理相关文件

2. 项目启动文件介绍

在使用 FullscreenVideoView 时，你的主要交互点将在于XML布局文件和对应的Activity/Fragment的Java或Kotlin代码中。

XML布局示例

在应用的UI部分，你将像下面这样在XML布局中声明 FullscreenVideoView 或其扩展版如 FullscreenVideoLayout:

<com.github.rtoshiro.view.video.FullscreenVideoView
    android:id="@+id/videoview"
    android:layout_width="match_parent"
    android:layout_height="match_parent"/>

这一步是启动过程中的一部分，确保正确导入了依赖，并在界面中预留了显示视频的位置。

Java或Kotlin初始化

接下来，在Activity或Fragment中，你需要初始化这个视图并设置视频源：

// Java
FullscreenVideoView videoView = findViewById(R.id.videoview);
videoView.setVideoURI(Uri.parse("http://example.com/path/to/video.mp4"));

或对于Kotlin:

// Kotlin
val videoView = findViewById<FullscreenVideoView>(R.id.videoview)
videoView.videoUrl("http://example.com/path/to/video.mp4")

3. 项目的配置文件介绍

build.gradle 文件

在项目级别的 build.gradle 中添加依赖以引入此库:

dependencies {
    implementation 'com.github.rtoshiro.fullscreenvideoview:fullscreenvideoview:1.1.2'
}

并确保已添加JCenter或Maven Central作为仓库：

repositories {
    mavenCentral()
}

AndroidManifest.xml 配置

为了支持屏幕旋转（如果需要全屏效果）而避免Activity重启，可以对Activity进行以下配置：

<activity
    android:name=".YourActivity"
    android:configChanges="orientation|screenSize">

这指示系统在方向变化时不会销毁和重建Activity，而是调用 onConfigurationChanged 方法来处理布局更改。

通过上述步骤，你可以集成 FullscreenVideoView 到你的Android应用中，提供视频的全屏播放能力。记得调整并测试适应不同场景下的用户体验。

FullscreenVideoView An Android Library to replace VideoView with Fullscreen feature 项目地址: https://gitcode.com/gh_mirrors/fu/FullscreenVideoView