【Sceneform-EQR】通过sceneform-eqr实现一个视频播放器（使用安卓MediaPlayer实现视频播放）

在前一篇文档中介绍了如何在AR\三维场景创建几种背景

【Sceneform-EQR】scenefrom-eqr中的几种背景实现(不仅用于AR、三维场景，在图片、视频播放器中也适用)

本文将侧重介绍如何使用安卓MediaPlayer实现视频播放。

↓↓↓↓↓↓↓↓↓↓↓↓ 以下正文 ↓↓↓↓↓↓↓↓↓↓↓↓

Sceneform-EQR

简介

Sceneform-EQR是EQ基于sceneform（filament）扩展的一个用于安卓端的三维渲染器。

MediaPlayer基础知识

若已熟悉MediaPlayer的使用，则可跳过本小节内容，直接看下一节 “使用MediaPlayer实现视频播放”

介绍

Android 的 MediaPlayer 是一个用于播放音频和视频的类，它支持多种格式的媒体文件和流媒体。它提供了非常高层次的接口，使开发者可以轻松实现媒体播放功能，如播放、暂停、停止、快进、倒退等操作。MediaPlayer 适用于需要播放本地或网络媒体资源的 Android 应用。

功能

支持的媒体类型：MediaPlayer 支持各种常见的媒体文件格式，如 MP3、MP4、MPEG、3GP、AAC、WAV、OGG 等，以及通过网络流式传输的音视频文件。
状态管理：MediaPlayer 有多个状态（如 Idle、Initialized、Prepared、Started、Paused 等），开发者需要在不同状态下正确调用方法以避免崩溃或错误。
事件监听：MediaPlayer 提供了多种监听器（如 OnPreparedListener、OnCompletionListener、OnErrorListener），以处理播放开始、完成、错误等事件。

使用步骤

初始化 MediaPlayer：首先，创建一个 MediaPlayer 对象，可以通过调用 new MediaPlayer() 或者使用静态方法 create() 进行初始化。
设置数据源：使用 setDataSource() 方法为 MediaPlayer 设置音频或视频文件的路径，数据源可以是本地文件、网络 URL 或者其他 URI。
准备播放：调用 prepare() 或 prepareAsync() 方法准备播放资源。对于大文件或网络资源，推荐使用异步准备（prepareAsync()），避免阻塞主线程。
开始播放：当资源准备好后，可以调用 start() 方法开始播放。
暂停和停止：可以使用 pause() 暂停播放，使用 stop() 完全停止播放。
释放资源：当不再需要 MediaPlayer 时，应该调用 release() 方法释放资源，避免内存泄漏。

监听事件

OnPreparedListener：当调用 prepareAsync() 后，资源准备完成时触发该监听器。

mediaPlayer.setOnPreparedListener(new MediaPlayer.OnPreparedListener() {
    @Override
    public void onPrepared(MediaPlayer mp) {
        // 开始播放
        mediaPlayer.start();
    }
});

OnCompletionListener：当播放完成时触发该监听器，可以用来处理播放结束后的操作。

mediaPlayer.setOnCompletionListener(new MediaPlayer.OnCompletionListener() {
    @Override
    public void onCompletion(MediaPlayer mp) {
        // 播放完成的逻辑
        mediaPlayer.stop();
    }
});

OnErrorListener：当播放过程中出现错误时触发该监听器，便于处理错误。

mediaPlayer.setOnErrorListener(new MediaPlayer.OnErrorListener() {
    @Override
    public boolean onError(MediaPlayer mp, int what, int extra) {
        // 错误处理逻辑
        return true;
    }
});

常见问题

主线程阻塞问题：prepare() 是同步方法，可能会阻塞主线程，尤其是在处理大文件或网络流媒体时。推荐使用 prepareAsync() 异步方法，它不会阻塞主线程，并在准备完成时通过 OnPreparedListener 通知。
内存泄漏问题：未释放 MediaPlayer 资源可能会导致内存泄漏。在 Activity 或 Fragment 销毁时，一定要调用 release() 释放资源。
音视频同步：MediaPlayer 支持同时播放音频和视频，但对于视频播放，可能会遇到音画不同步的问题。这种情况下，可能需要更高级的播放器（如 ExoPlayer）进行优化。

使用MediaPlayer实现视频播放

按惯例，先看结果，再贴代码，最后在补充。

示例结果

示例中实现了基础的视频播放，运行截图如下：
在这里插入图片描述

示例代码

Layout

添加场景布局控件SceneLayout，用于渲染视频。
添加VideoTimeLine组件，用于显示播放进度。

完整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=".VideoActivity">
    <com.eqgis.eqr.layout.SceneLayout
        android:id="@+id/video_scene_layout"
        android:layout_width="match_parent"
        android:layout_height="match_parent"/>

    <com.eqgis.media.component.VideoTimeLine
        android:layout_alignParentBottom="true"
        android:layout_marginBottom="20dp"
        android:id="@+id/time_line"
        android:layout_width="match_parent"
        android:layout_height="20dp"/>
    <TextView
        android:textSize="24sp"
        android:text="样例视频"
        android:layout_centerInParent="true"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"/>
</RelativeLayout>

VideoActivity

在Sceneform-EQR的SmapleProj中，写了个示例VideoActivity供参考。

当ExSceneView初始化成功后，使用MediaPlaer加载默认的视频。

public class VideoActivity extends BaseActivity{

    private ExternalTexture externalTexture;
    private MediaPlayer mediaPlayer;
    private VideoTimeLine videoTimeLine;

    @SuppressLint("MissingInflatedId")
    @Override
    protected void onCreate(Bundle savedInstanceState) {

        super.onCreate(savedInstanceState);

        //普通三维场景(场景3选1)
        setContentView(R.layout.activity_video_scene);
        sceneLayout = findViewById(R.id.video_scene_layout);
        sceneLayout.enableExSceneView(true).init(this);
        videoTimeLine = findViewById(R.id.time_line);

        sceneLayout.getExSceneView().setInitializeListener(new ExSceneView.InitializeListener() {
            @Override
            public void initializeTexture(ExternalTexture texture) {
                //纹理初始化成功时，触发回调
                externalTexture = texture;
                try {
                    loadDefaultVideo();
                } catch (IOException e) {
                    throw new RuntimeException(e);
                }
            }
        });
    }

    /**
     * 加载默认视频
     * @throws IOException
     */
    private void loadDefaultVideo() throws IOException {
        //这里使用eq_test_video.mp4为例，实际上，你也可以通过其它方式创建MediaPlayer，并设置数据源
        mediaPlayer = MediaPlayer.create(this,R.raw.eq_test_video);
        videoTimeLine.bindView(sceneLayout.getExSceneView(),mediaPlayer);
        mediaPlayer.setLooping(true);//循环播放
        mediaPlayer.setOnVideoSizeChangedListener(new MediaPlayer.OnVideoSizeChangedListener() {
            @Override
            public void onVideoSizeChanged(MediaPlayer mediaPlayer, int w, int h) {
                if (externalTexture != null){
                    externalTexture.getSurfaceTexture().setDefaultBufferSize(w, h);
                    mediaPlayer.setSurface(externalTexture.getSurface());
                }
            }
        });
        //就绪时，自动播放
        mediaPlayer.start();
    }
}

注意：在SceneLayout初始化（init方法）前，需要启用ExSceneView模式，因为只有ExSceneView实现了背景的扩展（能够获取SurfaceTexture对象），而这里我们要基于此去渲染视频。

补充内容

VideoTimeLine组件

源码：VideoTimeline.java

方式：
使用的是Seekbar去做的播放器的进度条，使用TextView显示时间文本。

关键点：

在Scene的onUpdate事件中，实时更新seekBar的进度。
在拖拽Seekbar时，通过mediaPlayer.seekTo更新视频进度。
此外，需要注意避免上述两点的相互调用引起的冲突。

视频播放

ExSceneView继承SceneView，可用于渲染任何被安卓Surface支持绘制的内容。

SceneLayout基于SceneView实现，通过两步即可将MediaPlayer的播放内容，绘制在SceneLayout组件中。

获取SceneLayout的externalTexture（通过ExSceneView获取）

方式1：初始化成功后回调

       sceneLayout.getExSceneView().setInitializeListener(new ExSceneView.InitializeListener() {
            @Override
            public void initializeTexture(ExternalTexture texture) {
                //纹理初始化成功时，触发回调
                externalTexture = texture;
                try {
                    loadDefaultVideo();
                } catch (IOException e) {
                    throw new RuntimeException(e);
                }
            }
        });

方式2：直接通过ExSceneView的getExternalTexture方法

    /**
     * 获取拓展纹理
     * @return {@link ExternalTexture}
     */
    @Nullable
    public ExternalTexture getExternalTexture() {
        return externalTexture;
    }

给MediaPlayer设置surface

        mediaPlayer.setOnVideoSizeChangedListener(new MediaPlayer.OnVideoSizeChangedListener() {
            @Override
            public void onVideoSizeChanged(MediaPlayer mediaPlayer, int w, int h) {
                if (externalTexture != null){
                    externalTexture.getSurfaceTexture().setDefaultBufferSize(w, h);
                    mediaPlayer.setSurface(externalTexture.getSurface());
                }
            }
        });