鸿蒙HarmonyOS开发实战—多媒体开发（媒体会话管理开发）_鸿蒙多媒体开发enableAVSessionActiv

AVElement的主要接口

接口名	描述
AVElement(AVDescription description, int flags)	构造AVElement实例。
getFlags()	获取flags的值。
isScannable()	判断媒体是否可扫描，如：媒体有子节点，则可继续扫描获取子节点内容。
isPlayable()	检查媒体是否可播放。
getAVDescription()	获取媒体的详细信息。
getMediaId()	获取媒体的id。

开发步骤

使用AVSession媒体框架创建一个播放器示例，分为创建客户端和创建服务端。

创建客户端

在客户端AVClientAbility中声明avBrowser和avController，通过avBrowser并向服务端发送连接请求，然后将avController注册到ability。

public class AVClientAbility extends Ability { // 媒体浏览器 private AVBrowser avBrowser; // 媒体控制器 private AVController avController; // 服务端回传的媒体列表 List avElements; @Override public void onStart(Intent intent) { super.onStart(intent); // 用于指向媒体浏览器服务的包路径和类名 ElementName elementName = new ElementName("", "com.samples.audioplayer", "com.samples.audioplayer.AVService"); // connectionCallback在调用avBrowser.connect方法后进行回调。 avBrowser = new AVBrowser(context, elementName, connectionCallback, null); // avBrowser发送对媒体浏览器服务的连接请求,connect方法需要确保当前处于断开连接状态。 avBrowser.connect(); // 将媒体控制器注册到ability以接收按键事件。 AVController.setControllerForAbility(this, avController); } }

复制

AVConnectionCallback回调接口中的方法为可选实现，通常需要会在onConnected中订阅媒体数据和创建媒体控制器AVController。

// 发起连接（avBrowser.connect）后的回调方法实现 private AVConnectionCallback connectionCallback = new AVConnectionCallback() { @Override public void onConnected() { // 成功连接媒体浏览器服务时回调该方法，否则回调onConnectionFailed()。 // 重复订阅会报错，所以先解除订阅。 avBrowser.unsubscribeByParentMediaId(avBrowser.getRootMediaId()); // 第二个参数AVSubscriptionCallback，用于处理订阅信息的回调。 avBrowser.subscribeByParentMediaId(avBrowser.getRootMediaId(), avSubscriptionCallback); AVToken token = avBrowser.getAVToken(); avController = new AVController(AVClient.this, token); // AVController第一个参数为当前类的context // 参数AVControllerCallback，用于处理服务端播放状态及信息变化时回调。 avController.setAVControllerCallback(avControllerCallback); // ... } // 其它回调方法（可选） // ... };

复制

通常在订阅成功时，在AVSubscriptionCallback回调接口onAVElementListLoaded中保存服务端回传的媒体列表。

// 发起订阅信息(avBrowser.subscribeByParentMediaId)后的回调方法实现 private AVSubscriptionCallback avSubscriptionCallback = new AVSubscriptionCallback() { @Override public void onAVElementListLoaded(String parentId, List children) { // 订阅成功时回调该方法，parentID为标识，children为服务端回传的媒体列表 super.onAVElementListLoaded(parentId, children); avElements.addAll(children); // ... } };

复制

AVControllerCallback回调接口中的方法均为可选方法，主要用于服务端播放状态及信息的变化后对客户端的回调，客户端可在这些方法中实现UI的刷新。

// 服务对客户端的媒体数据或播放状态变更后的回调 private AVControllerCallback avControllerCallback = new AVControllerCallback() { @Override public void onAVMetadataChanged(AVMetadata metadata) { // 当服务端调用avSession.setAVMetadata(avMetadata)时，此方法会被回调。 super.onAVMetadataChanged(metadata); AVDescription description = metadata.getAVDescription(); String title = description.getTitle().toString(); PixelMap pixelMap = description.getIcon(); // ... } @Override public void onAVPlaybackStateChanged(AVPlaybackState playbackState) { // 当服务端调用avSession.setAVPlaybackState(...)时，此方法会被回调。 super.onAVPlaybackStateChanged(playbackState); long position = playbackState.getCurrentPosition(); // ... } // 其它回调方法（可选） // ... };

复制

完成以上实现后，则应用可以在UI事件中调用avController的方法向服务端发送播放控制指令。

// 在UI播放与暂停按钮的点击事件中向服务端发送播放或暂停指令 public void toPlayOrPause() { switch (avController.getAVPlaybackState().getAVPlaybackState()) { case AVPlaybackState.PLAYBACK_STATE_NONE: { avController.getPlayControls().prepareToPlay(); avController.getPlayControls().play(); break; } case AVPlaybackState.PLAYBACK_STATE_PLAYING: { avController.getPlayControls().pause(); break; } case AVPlaybackState.PLAYBACK_STATE_PAUSED: { avController.getPlayControls().play(); break; } default: { // ... } } }

复制

其它播放控制根据业务是否需要实现，比如：

avController.getPlayControls().playNext(); avController.getPlayControls().playPrevious(); avController.getPlayControls().playFastForward(); avController.getPlayControls().rewind(); avController.getPlayControls().seekTo(1000); avController.getPlayControls().stop(); // ...

复制

也可以主动获取媒体信息、播放状态等数据：

AVMetadata avMetadata = avController.getAVMetadata(); AVPlaybackState avPlaybackState = avController.getAVPlaybackState(); // ...

复制

创建服务端

在服务端AVService中声明AVSession和Player。

public class AVService extends AVBrowserService { // 根媒体ID private static final String AV_ROOT_ID = "av_root_id"; // 媒体会话 private AVSession avSession; // 媒体播放器 private Player player;

@Override public void onStart(Intent intent) { super.onStart(intent); avSession = new AVSession(this, "AVService"); setAVToken(avSession.getAVToken()); // 设置sessioncallback，用于响应客户端的媒体控制器发起的播放控制指令。 avSession.setAVSessionCallback(avSessionCallback); // 设置播放状态初始状态为AVPlaybackState.PLAYBACK_STATE_NONE。 AVPlaybackState playbackState = new AVPlaybackState.Builder().setAVPlaybackState(AVPlaybackState.PLAYBACK_STATE_NONE, 0, 1.0f).build(); avSession.setAVPlaybackState(playbackState); // 完成播放器的初始化，如果使用多个Player，也可以在执行播放时初始化。 player = new Player(this); } @Override public AVBrowserRoot onGetRoot(String clientPackageName, int clientUid, PacMap rootHints) { // 响应客户端avBrowser.connect()方法。若同意连接，则返回有效的AVBrowserRoot实例，否则返回null return new AVBrowserRoot(AV_ROOT_ID, null); } @Override public void onLoadAVElementList(String parentId, AVBrowserResult result) { HiLog.info(TAG, "onLoadChildren"); // 响应客户端avBrowser.subscribeByParentMediaId(...)方法。 // 先执行该方法detachForRetrieveAsync() result.detachForRetrieveAsync(); // externalAudioItems缓存媒体文件，请开发者自行实现。 result.sendAVElementList(externalAudioItems.getAudioItems()); } @Override public void onLoadAVElementList(String s, AVBrowserResult avBrowserResult, PacMap pacMap) { // 响应客户端avBrowser.subscribeByParentMediaId(String, PacMap, AVSubscriptionCallback)方法。 } @Override public void onLoadAVElement(String s, AVBrowserResult avBrowserResult) { // 响应客户端avBrowser.getAVElement(String, AVElementCallback)方法。 } }

复制

响应客户端的媒体控制器发起的播放控制指令的回调实现。

private AVSessionCallback avSessionCallback = new AVSessionCallback() { @Override public void onPlay() { super.onPlay(); // 当客户端调用avController.getPlayControls().play()时，该方法会被回调。 // 响应播放请求，开始播放。 if (avSession.getAVController().getAVPlaybackState() == AVPlaybackState.PLAYBACK_STATE_PAUSED) { if (player.play()) { AVPlaybackState playbackState = new AVPlaybackState.Builder().setAVPlaybackState( AVPlaybackState.PLAYBACK_STATE_PLAYING, player.getCurrentTime(), player.getPlaybackSpeed()).build(); avSession.setAVPlaybackState(playbackState); } } } @Override public void onPause() { super.onPause(); // 当客户端调用avController.getPlayControls().pause()时，该方法会被回调。 // 响应暂停请求，暂停播放。 } @Override public void onPlayNext() { super.onPlayNext(); // 当客户端调用avController.getPlayControls().playNext()时，该方法会被回调。 // 响应播放下一曲请求，通过avSession.setAVMetadata设置下一曲曲目的信息。 avSession.setAVMetadata(avNextMetadata); } // 重写以处理按键事件 @Override public boolean onMediaButtonEvent(Intent mediaButtonIntent) { KeyEvent ke = mediaButtonIntent.getSequenceableParam(AVSession.PARAM_KEY_EVENT); if (ke == null) { HiLog.error(TAG, "getSequenceableParam failed"); return false; } if (ke.isKeyDown()) { // 只处理按键抬起事件 return true; }

switch (ke.getKeyCode()) { case KeyEvent.KEY_MEDIA_PLAY_PAUSE: { if (playbackState.getAVPlaybackState() == AVPlaybackState.PLAYBACK_STATE_PAUSED) { onPlay(); break; } if (playbackState.getAVPlaybackState() == AVPlaybackState.PLAYBACK_STATE_PLAYING) { onPause(); break; } break; } case KeyEvent.KEY_MEDIA_PLAY: { onPlay(); break; } case KeyEvent.KEY_MEDIA_PAUSE: { onPause(); break; } case KeyEvent.KEY_MEDIA_STOP: { onStop(); break; } case KeyEvent.KEY_MEDIA_NEXT: { onPlayNext(); break; } case KeyEvent.KEY_MEDIA_PREVIOUS: { onPlayPrevious(); break; } default: { break; } } return true; } // 其它回调方法（可选） // ... }

最后，为了能让大家更好的去学习提升鸿蒙 (Harmony OS) 开发技术，小编连夜整理了一份30个G纯血版学习资料（含视频、电子书、学习文档等）以及一份在Github上持续爆火霸榜的《纯血版华为鸿蒙 (Harmony OS)开发手册》（共计890页），希望对大家有所帮助。