Android 视频播放器完整指南

androidmobile developmentapps/applications更新于 2026/2/8 23:22:17

什么是 Android 视频播放器?

在本教程中，我们将学习如何使用 Kotlin 编程语言在 Android 应用程序中构建视频播放器。

视频播放器是 Android 中的一个小部件，用于在 Android 应用程序中访问视频文件。借助此视频播放器，我们可以在 Android 应用程序中观看视频。

视频播放器的实现

我们将创建一个简单的应用程序，其中我们将使用视频视图在 Android 应用程序中播放视频。我们将按照分步指南在 Android 应用程序中实现 Toast 消息。

步骤 1:在 Android Studio 中创建新项目

如下图所示，导航到 Android Studio。在下面的屏幕中，点击"新建项目"创建一个新的 Android Studio 项目。

点击"新建项目"后，您将看到下面的屏幕。

在此屏幕中，我们只需选择"空活动"并点击"下一步"。点击"下一步"后，您将看到以下屏幕。

在此屏幕中，我们只需指定项目名称。然后包名称将自动生成。

注意- 确保选择"语言"为 Kotlin。

指定所有详细信息后，点击"完成"以创建一个新的 Android Studio 项目。

项目创建完成后，我们将看到两个打开的文件，即 activity_main.xml 和 MainActivity.kt 文件。

步骤 2:使用 activity_main.xml

导航到 activity_main.xml。如果看不到此文件，请打开它。在左侧窗格中，导航至 app>res>layout>activity_main.xml 并打开此文件。打开此文件后，添加以下代码。代码中添加了注释，以便您详细了解。

<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout 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=".MainActivity">

   <!-- creating a video view on below line-->
   <VideoView
      android:id="@+id/idVideoView"
      android:layout_width="match_parent"
      android:layout_height="wrap_content"
      android:layout_centerInParent="true" />

</RelativeLayout>

说明− 在上述代码中，根元素是 Android 中的相对布局。此布局是一个视图组，用于将其中的所有元素彼此对齐。我们可以借助 ID 或位置来相对对齐相对布局中的所有元素。

在这个相对布局中，我们创建了用于在 Android 应用程序中播放视频的视频视图。首先，我们在此视频视图中指定唯一的 ID，以便我们可以使用它来加载视频。然后，我们指定视频视图的高度和宽度。然后，我们将视频视图与屏幕中心对齐。

最后，我们为相对布局添加一个结束标记，因为文本视图和按钮包含在相对布局中。

步骤 3:在 Android Studio 项目中添加视频

要在 Android 应用程序中添加视频，我们只需复制要在视频视图中播放的视频即可。然后，我们需要导航到我们的 Android Studio 项目。在项目中，导航至 app>res>右键单击它>New>Directory，并将其名称指定为 raw。之后，只需右键单击该目录，然后单击"粘贴"选项即可将视频添加到我们的项目中。请确保将视频名称指定为"video"，因为我们在项目中使用此视频时将使用相同的名称。

步骤 4:使用 MainActivity.kt

导航到 MainActivity.kt。如果此文件不可见，请打开此文件。在左侧窗格中，导航至 app>java>您的应用包名称>MainActivity.kt 以打开此文件。打开此文件后，请将以下代码添加到其中。代码中添加了注释，以便您详细了解。

package com.example.gptapp

import android.net.Uri
import android.os.Bundle
import android.widget.MediaController
import android.widget.VideoView
import androidx.appcompat.app.AppCompatActivity

class MainActivity : AppCompatActivity() {

    // 在下面的代码中为视频视图创建变量。
    lateinit var videoView: VideoView
    
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)
        // 在下面的代码中初始化视频视图的变量。
        videoView = findViewById(R.id.idVideoView)
        
        // 在下面的代码中创建并初始化媒体控制器的变量。
        val mediaController = MediaController(this)
        // 在下面的代码中将媒体控制器锚点视图设置为视频视图。
        mediaController.setAnchorView(videoView)
        // 在下面的代码中，我们获取了要添加到项目中的视频文件的 URI。
        val uri: Uri = Uri.parse("android.resource://" + packageName + "/" + R.raw.video)
        // 在下面的代码中，我们为视频视图设置了媒体控制器。
        videoView.setMediaController(mediaController);
        // 下面一行我们为视频视图设置视频 URI。
        videoView.setVideoURI(uri);
        // 下面一行我们请求视频视图的焦点。
        videoView.requestFocus();
        // 下面一行我们调用 start 方法来启动视频视图。
        videoView.start();
   }
}

说明− 在上述 MainActivity.kt 文件的代码中，我们首先为视频视图创建一个变量。

现在我们来看一下 onCreate 方法。这是每个 Android 应用程序的默认方法。此方法在应用程序视图创建时调用。在此方法中，我们设置内容视图，即名为 activity_main.xml 的布局文件，并从该文件设置 UI。

指定视图后，我们将使用在 activity_main.xml 文件中指定的唯一 ID 初始化名为 videoView 的视频视图变量。

初始化 videoView 后，我们将创建并初始化媒体控制器的变量。媒体控制器用于控制媒体播放，用于播放和暂停视频。我们可以使用媒体控制器来前后移动视频。初始化媒体控制器后，我们将媒体控制器的锚点视图设置为视频视图。然后，我们创建一个 uri 变量，用于生成我们添加到项目 raw 文件夹中的视频文件的路径。初始化视频 uri 后，我们将设置视频视图的媒体控制器，以控制视频视图中正在播放的视频。然后，我们将视频 uri 加载到视频视图中。最后，我们请求视频视图的焦点，然后通过调用 start 方法启动视频视图。

添加上述代码后，只需点击顶部栏中的绿色图标即可在移动设备上运行我们的应用程序。

注意− 确保您已连接到真实设备或模拟器。