【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() {@Overridepublic void onPrepared(MediaPlayer mp) {// 开始播放mediaPlayer.start();}
});

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

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

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

mediaPlayer.setOnErrorListener(new MediaPlayer.OnErrorListener() {@Overridepublic 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.SceneLayoutandroid:id="@+id/video_scene_layout"android:layout_width="match_parent"android:layout_height="match_parent"/><com.eqgis.media.component.VideoTimeLineandroid:layout_alignParentBottom="true"android:layout_marginBottom="20dp"android:id="@+id/time_line"android:layout_width="match_parent"android:layout_height="20dp"/><TextViewandroid: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")@Overrideprotected 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() {@Overridepublic 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() {@Overridepublic 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() {@Overridepublic void initializeTexture(ExternalTexture texture) {//纹理初始化成功时，触发回调externalTexture = texture;try {loadDefaultVideo();} catch (IOException e) {throw new RuntimeException(e);}}});

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

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

给MediaPlayer设置surface

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