鸿蒙应用开发：实现简单的媒体播放器原创精华

ZEGO即构

发布于 2021-12-10 14:26

浏览

3收藏

距离 Harmony OS 发布已过去了一段时间，为了了解鸿蒙系统的功能与特性，今天我们将准备使用系统 API 实现一个简单的媒体播放器 demo。

大家在阅读本文后会对媒体播放器相关的 API 有一定的了解，并且可以根据文中的步骤一起动手实操，实现在鸿蒙系统上的简单媒体播放器！

VideoPlayerDemo 仓库地址：https://gitee.com/wangx-six/video-player-demo

话不多说，下面我将带领大家一起看一下媒体播放器的实现流程。

一、媒体资源文件的权限申请

Harmony OS 中所有的应用均在应用沙盒内运行。默认情况下，应用只能访问有限的系统资源，系统负责管理应用对资源的访问权限。

所以要实现媒体播放器功能当然需要访问媒体资源，这时就需要向操作系统申请权限：

1、需要在 config.json 中的 "“reqPermissions” 添加配置：

"reqPermissions": [
  {
    "name": "ohos.permission.READ_USER_STORAGE"
  }
]
1.
2.
3.
4.
5.

2、需要在程序启动时请求读取本地媒体资源的权限：

if (verifyCallingOrSelfPermission(SystemPermission.READ_USER_STORAGE) != IBundleManager.PERMISSION_GRANTED) {
    requestPermissionsFromUser(new String[]{SystemPermission.READ_USER_STORAGE}, REQUEST_CODE);
}
1.
2.
3.

二、获取本地的媒体资源文件

在申请到媒体资源的权限后，我们就可以去获取本地的媒体资源信息，包括音频及视频。

我们可以通过以下操作，将所有的音视频文件标识为 AVElement 并存入 List<AVElement> 中方便我们做 UI 展示，稍后可通过 AVElement 获取媒体资源文件路径，传递给系统播放器。

private final List<AVElement> avElements = new ArrayList<>();

public VideoElementManager(Context context) {
    loadAudioFromMediaLibrary(context);
    loadVideoFromMediaLibrary(context);
}

// 查找音频
private void loadAudioFromMediaLibrary(Context context) {
    Uri audioUri = AVStorage.Audio.Media.EXTERNAL_DATA_ABILITY_URI;
    DataAbilityHelper helper = DataAbilityHelper.creator(context, audioUri, false);
    try {
        ResultSet resultSet = helper.query(audioUri, null, null);
        LogUtil.info(TAG, "The audio result size: " + resultSet.getRowCount());
        processResult(resultSet);
        resultSet.close();
    } catch (DataAbilityRemoteException e) {
        LogUtil.error(TAG, "Query system media failed.");
    } finally {
        helper.release();
    }
}

// 查找视频
private void loadVideoFromMediaLibrary(Context context) {
    Uri videoUri = AVStorage.Video.Media.EXTERNAL_DATA_ABILITY_URI;
    DataAbilityHelper helper = DataAbilityHelper.creator(context, videoUri, false);
    try {
        ResultSet resultSet = helper.query(videoUri, null, null);
        LogUtil.info(TAG, "The video result size: " + resultSet.getRowCount());
        processResult(resultSet);
        resultSet.close();
    } catch (DataAbilityRemoteException e) {
        LogUtil.error(TAG, "Query system media failed.");
    } finally {
        helper.release();
    }
}

// 处理数据到 List<AVElement>
private void processResult(ResultSet resultSet) {
    while (resultSet.goToNextRow()) {
        String path = resultSet.getString(resultSet.getColumnIndexForName(AVStorage.AVBaseColumns.DATA));
        String title = resultSet.getString(resultSet.getColumnIndexForName(AVStorage.AVBaseColumns.TITLE));
        AVDescription bean =
                new AVDescription.Builder().setTitle(title).setIMediaUri(Uri.parse(path)).setMediaId(path).build();
        avElements.add(new AVElement(bean, AVElement.AVELEMENT_FLAG_PLAYABLE));
    }
}

1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.
24.
25.
26.
27.
28.
29.
30.
31.
32.
33.
34.
35.
36.
37.
38.
39.
40.
41.
42.
43.
44.
45.
46.
47.
48.
49.
50.

三、简单的播放功能实现

通过以上的步骤，我们已经获取了媒体资源权限，并且获取到本地的所有音视频，下面我们将通过调用系统 API 实现简单的播放功能。

下图为媒体播放器界面：

通过上面的 UI 界面，我们可以清晰的看出要实现哪些简单功能，例如播放、暂停、恢复、跳转、音量调节、倍速播放和播放进度更新。

下面将给大家详细介绍以上这些功能的具体实现方法。

1、渲染 View 准备

需要播放媒体资源，特别是视频资源，我们当然需要有 View 去渲染，鸿蒙系统 API 需要设置的 View 是 Surface，我们通过以下方法获取 Surface。

// 声明 SurfaceProvider, Surface
private SurfaceProvider surfaceProvider;
private DirectionalLayout playViewLayout;
private Surface surface;

private void addSurfaceProvider() {
    surfaceProvider = new SurfaceProvider(this);

    if (surfaceProvider.getSurfaceOps().isPresent()) {
        surfaceProvider.getSurfaceOps().get().addCallback(new SurfaceCallBack());
        surfaceProvider.pinToZTop(true);
    }
}

// 生成 Surface 的回调
class SurfaceCallBack implements SurfaceOps.Callback {
    @Override
    public void surfaceCreated(SurfaceOps callbackSurfaceOps) {
        if (surfaceProvider.getSurfaceOps().isPresent()) {
            surface = surfaceProvider.getSurfaceOps().get().getSurface();
            LogUtil.info(TAG, "surface set");
        }
    }

    @Override
    public void surfaceChanged(SurfaceOps callbackSurfaceOps, int format, int width, int height) {
        LogUtil.info(TAG, "surface changed");
    }

    @Override
    public void surfaceDestroyed(SurfaceOps callbackSurfaceOps) {
        LogUtil.info(TAG, "surface destroyed");
    }
}
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.
24.
25.
26.
27.
28.
29.
30.
31.
32.
33.
34.

playViewLayout = (DirectionalLayout) findComponentById(ResourceTable.Id_playViewLayout);
playViewLayout.addComponent(surfaceProvider);
1.
2.

2、播放

我们获取到 Surface 后就可以调用系统 API 进行播放了。以下是对系统 API 的简单封装，我们可以调用 play 接口播放媒体资源。

private Player videoPlayer;
private Runnable videoRunnable;

public synchronized void play(AVElement avElement, Surface surface) {
    if (videoPlayer != null) {
        // 关闭当前播放资源
        // release 会重置播放状态并关闭定时器
        videoPlayer.stop();
        videoPlayer.release();
        videoPlayer = null;
    }

    if (videoRunnable != null) {
        ThreadPoolManager.getInstance().cancel(videoRunnable);
    }

    videoPlayer = new Player(context);
    setPlayerCallback();

    videoRunnable = () -> playInner(avElement, surface);
    ThreadPoolManager.getInstance().execute(videoRunnable);
    LogUtil.info(TAG, "play");
}

private void playInner(AVElement avElement, Surface surface) {
    Source source = new Source(avElement.getAVDescription().getMediaUri().toString());
    videoPlayer.setSource(source);
    videoPlayer.setVideoSurface(surface);
    LogUtil.info(TAG, source.getUri());

    videoPlayer.prepare();
    videoPlayer.play();
    playbackState = PlaybackState.VIDEO_PLAYER_PLAYING;
    startTimer();
}

// 设置 Callback
private void setPlayerCallback() {
    videoPlayer.setPlayerCallback(new Player.IPlayerCallback() {
        @Override
        public void onPrepared() {
            if (eventHandler == null) {
                return;
            }
            EventHandler handler = new EventHandler(EventRunner.getMainEventRunner());
            handler.postTask(new Runnable() {
                @Override
                public void run() {
                    eventHandler.onPrepared();
                }
            });
        }

        @Override
        public void onMessage(int type, int extra) {
            if (eventHandler == null) {
                return;
            }
            EventHandler handler = new EventHandler(EventRunner.getMainEventRunner());
            handler.postTask(new Runnable() {
                @Override
                public void run() {
                    eventHandler.onMessage(type, extra);
                }
            });
        }

        @Override
        public void onError(int errorType, int errorCode) {
            if (eventHandler == null) {
                return;
            }
            EventHandler handler = new EventHandler(EventRunner.getMainEventRunner());
            handler.postTask(new Runnable() {
                @Override
                public void run() {
                    eventHandler.onError(errorType, errorCode);
                }
            });
        }

        @Override
        public void onResolutionChanged(int width, int height) {
            if (eventHandler == null) {
                return;
            }
            EventHandler handler = new EventHandler(EventRunner.getMainEventRunner());
            handler.postTask(new Runnable() {
                @Override
                public void run() {
                    eventHandler.onResolutionChanged(width, height);
                }
            });
        }

        @Override
        public void onPlayBackComplete() {
            playbackState = PlaybackState.VIDEO_PLAYER_PLAY_ENDED;
            endTimer();
            if (eventHandler == null) {
                return;
            }
            EventHandler handler = new EventHandler(EventRunner.getMainEventRunner());
            handler.postTask(new Runnable() {
                @Override
                public void run() {
                    eventHandler.onPlayBackComplete();
                }
            });
        }

        @Override
        public void onRewindToComplete() {
            if (eventHandler == null) {
                return;
            }
            EventHandler handler = new EventHandler(EventRunner.getMainEventRunner());
            handler.postTask(new Runnable() {
                @Override
                public void run() {
                    eventHandler.onRewindToComplete();
                }
            });
        }

        @Override
        public void onBufferingChange(int percent) {
            if (eventHandler == null) {
                return;
            }
            EventHandler handler = new EventHandler(EventRunner.getMainEventRunner());
            handler.postTask(new Runnable() {
                @Override
                public void run() {
                    eventHandler.onBufferingChange(percent);
                }
            });
        }

        @Override
        public void onNewTimedMetaData(Player.MediaTimedMetaData mediaTimedMetaData) {
            if (eventHandler == null) {
                return;
            }
            EventHandler handler = new EventHandler(EventRunner.getMainEventRunner());
            handler.postTask(new Runnable() {
                @Override
                public void run() {
                    eventHandler.onNewTimedMetaData(mediaTimedMetaData);
                }
            });
        }

        @Override
        public void onMediaTimeIncontinuity(Player.MediaTimeInfo mediaTimeInfo) {
            if (eventHandler == null) {
                return;
            }
            EventHandler handler = new EventHandler(EventRunner.getMainEventRunner());
            handler.postTask(new Runnable() {
                @Override
                public void run() {
                    eventHandler.onMediaTimeIncontinuity(mediaTimeInfo);
                }
            });
        }
    });
}
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.
24.
25.
26.
27.
28.
29.
30.
31.
32.
33.
34.
35.
36.
37.
38.
39.
40.
41.
42.
43.
44.
45.
46.
47.
48.
49.
50.
51.
52.
53.
54.
55.
56.
57.
58.
59.
60.
61.
62.
63.
64.
65.
66.
67.
68.
69.
70.
71.
72.
73.
74.
75.
76.
77.
78.
79.
80.
81.
82.
83.
84.
85.
86.
87.
88.
89.
90.
91.
92.
93.
94.
95.
96.
97.
98.
99.
100.
101.
102.
103.
104.
105.
106.
107.
108.
109.
110.
111.
112.
113.
114.
115.
116.
117.
118.
119.
120.
121.
122.
123.
124.
125.
126.
127.
128.
129.
130.
131.
132.
133.
134.
135.
136.
137.
138.
139.
140.
141.
142.
143.
144.
145.
146.
147.
148.
149.
150.
151.
152.
153.
154.
155.
156.
157.
158.
159.
160.
161.
162.
163.
164.
165.
166.
167.
168.

3、暂停、恢复和跳转

实现一个媒体播放器，我们当然是需要暂停、恢复和跳转功能，以下是简单的封装。

这里有一个问题大家需要注意，虽然系统 API 中 getCurrentTime 接口返回值单位是毫秒，但是跳转接口 rewindTo 的接口参数单位是微秒。

// 暂停
public synchronized void pause() {
    if (videoPlayer == null) {
        return;
    }
    videoPlayer.pause();
    playbackState = PlaybackState.VIDEO_PLAYER_PAUSING;
    endTimer();
    LogUtil.info(TAG, "pause");
}

// 恢复
public synchronized void resume() {
    if (videoPlayer == null) {
        return;
    }
    videoPlayer.play();
    playbackState = PlaybackState.VIDEO_PLAYER_PLAYING;
    startTimer();
    LogUtil.info(TAG, "resume");
}

// 跳转
public synchronized void seekTo(long millisecond) {
    if (videoPlayer == null) {
        return;
    }

    // 注意，rewindTo 接口参数单位是微秒
    videoPlayer.rewindTo(millisecond * 1000);
    LogUtil.info(TAG, "seek" + videoPlayer.getCurrentTime());
}
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.
24.
25.
26.
27.
28.
29.
30.
31.
32.

4、时长获取和播放进度显示

我们对获取时长接口做了简单的封装，但是系统 API 中没有相关的播放进度回调，为了进行 UI 展示，我们需要自己维护一个播放状态和定时器去定时获取当前播放进度。

// 获取资源总时长，需要收到 onPrepared 回调后调用
public synchronized int getDuration() {
    if (videoPlayer == null) {
        return 0;
    }

    return videoPlayer.getDuration();
}

private Timer timer;
private PlaybackState playbackState;

private void startTimer() {
    if (timer == null) {
        timer = new Timer("PlaybackPorgressTimer");
        timer.schedule(new TimerTask() {
            @Override
            public void run() {
                playbackProgressUpdate();
            }
        }, 200L, 200L);
    }
}

private void endTimer() {
    if (timer == null) {
        return;
    }
    timer.cancel();
    timer = null;
}

private void playbackProgressUpdate() {
    if (eventHandler == null || videoPlayer == null) {
        return;
    }
    int currentPlaybackProgress = videoPlayer.getCurrentTime();
    EventHandler handler = new EventHandler(EventRunner.getMainEventRunner());
    handler.postTask(new Runnable() {
        @Override
        public void run() {
            eventHandler.onPlaybackProgressUpdate(currentPlaybackProgress);
        }
    });
}
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.
24.
25.
26.
27.
28.
29.
30.
31.
32.
33.
34.
35.
36.
37.
38.
39.
40.
41.
42.
43.
44.
45.

5、音量调节和倍速播放

鸿蒙播放器系统 API 同样暴露了音量调节和倍速播放的接口，不过需要注意的是音量调节的系统 API 参数范围是 0.0～1.0，改接口仅控制播放器的音量，与手机侧边音量控制无关，有兴趣的话可以自己测试一下。

public synchronized void setPlaybackVolume(int volume) {
    if (videoPlayer == null) {
        return;
    }

    videoPlayer.setVolume((float) ((float) volume/100.0));
}

public synchronized void setPlaybackSpeed(float speed) {
    if (videoPlayer == null) {
        return;
    }

    videoPlayer.setPlaybackSpeed(speed);
}

public synchronized float getPlaybackSpeed() {
    if (videoPlayer == null) {
        return 0.0f;
    }

    return videoPlayer.getPlaybackSpeed();
}
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.

四、总结

通过调用系统 API 实现一个简单的媒体播放器，相信大家一定对 Harmony OS都有了初步的了解与认识，比如说真正意义上的跑起来一个鸿蒙 APP，中间经过了开发者账号的申请、APP 证书的申请等等。

在11月底，ZEGO 即构科技首发适配鸿蒙系统的 Express SDK 1.0 版本，并正式启动了公测，这其中包括摄像头、麦克风、扬声器等设备的深度兼容与适配，实现了更加稳定、快速的设备管理能力，感兴趣可点击链接了解：https://mp.weixin.qq.com/s/dTHCKoFNFrakgdEwAddCZA

分类

标签

已于2021-12-10 18:29:25修改

51CTO

51CTO博客

51CTO学堂

鸿蒙应用开发：实现简单的媒体播放器原创精华

一、媒体资源文件的权限申请

二、获取本地的媒体资源文件

三、简单的播放功能实现

1、渲染 View 准备

2、播放

3、暂停、恢复和跳转

4、时长获取和播放进度显示

5、音量调节和倍速播放

四、总结

目录

订阅鸿蒙技术特刊，精选内容抢先看

51CTO

51CTO博客

51CTO学堂

鸿蒙应用开发：实现简单的媒体播放器 原创 精华

一、媒体资源文件的权限申请

二、获取本地的媒体资源文件

三、简单的播放功能实现

1、渲染 View 准备

2、播放

3、暂停、恢复和跳转

4、时长获取和播放进度显示

5、音量调节和倍速播放

四、总结

目录

订阅鸿蒙技术特刊，精选内容抢先看

鸿蒙应用开发：实现简单的媒体播放器原创精华