在.NET MAUI中实现Android系统UI媒体控制功能的技术求助

核心思路 #

由于.NET MAUI的MediaElement未直接封装Android系统媒体控制能力，需通过平台特定代码结合Android原生组件实现——核心依赖MediaSessionCompat管理媒体会话、NotificationCompat构建控制通知，再通过跨组件通信触发MAUI端的播放逻辑。

具体步骤 #

1. 编写Android平台媒体会话管理类 #

在项目Platforms/Android目录下新建MediaSessionManager.cs，封装会话创建、回调处理和通知更新：

using Android.App;
using Android.Media;
using Android.OS;
using Android.Support.V4.Media.Session;
using AndroidX.Core.App;

namespace YourAppName.Platforms.Android;

public class MediaSessionManager
{
    private readonly MediaSessionCompat _mediaSession;
    private readonly NotificationManager _notificationManager;
    private const int NotificationId = 1001;
    private const string ChannelId = "MediaPlayerChannel";

    public MediaSessionManager(Context context)
    {
        // 初始化媒体会话，声明支持的控制类型
        _mediaSession = new MediaSessionCompat(context, "MediaPlayerSession");
        _mediaSession.SetFlags(MediaSessionCompat.FlagHandlesMediaButtons | MediaSessionCompat.FlagHandlesTransportControls);
        _mediaSession.SetCallback(new MediaSessionCallback());

        // 创建通知渠道（Android 8.0+强制要求）
        _notificationManager = (NotificationManager)context.GetSystemService(Context.NotificationService);
        CreateNotificationChannel();
    }

    private void CreateNotificationChannel()
    {
        if (Build.VERSION.SdkInt >= BuildVersionCodes.O)
        {
            var channel = new NotificationChannel(ChannelId, "媒体播放控制", NotificationImportance.Low)
            {
                Description = "显示播放状态及控制按钮"
            };
            _notificationManager.CreateNotificationChannel(channel);
        }
    }

    // 根据播放状态更新通知和会话信息
    public void UpdatePlaybackState(bool isPlaying, long position, long duration)
    {
        var playbackState = new PlaybackStateCompat.Builder()
            .SetState(isPlaying ? PlaybackStateCompat.StatePlaying : PlaybackStateCompat.StatePaused, position, 1.0f)
            .SetActions(PlaybackStateCompat.ActionPlay | PlaybackStateCompat.ActionPause | PlaybackStateCompat.ActionSkipToNext | PlaybackStateCompat.ActionSkipToPrevious)
            .Build();
        
        _mediaSession.SetPlaybackState(playbackState);

        // 构建带控制按钮的通知
        var notificationBuilder = new NotificationCompat.Builder(Android.App.Application.Context, ChannelId)
            .SetContentTitle("当前曲目标题")
            .SetContentText("艺术家/专辑信息")
            .SetSmallIcon(Resource.Drawable.ic_notification)
            .SetStyle(new androidx.media.app.NotificationCompat.MediaStyle()
                .SetMediaSession(_mediaSession.SessionToken)
                .SetShowActionsInCompactView(0,1)) // 紧凑视图仅显示播放/暂停
            .AddAction(Resource.Drawable.ic_prev, "上一首", MediaButtonReceiver.BuildMediaButtonPendingIntent(Android.App.Application.Context, PlaybackStateCompat.ActionSkipToPrevious))
            .AddAction(isPlaying ? Resource.Drawable.ic_pause : Resource.Drawable.ic_play, isPlaying ? "暂停" : "播放", MediaButtonReceiver.BuildMediaButtonPendingIntent(Android.App.Application.Context, isPlaying ? PlaybackStateCompat.ActionPause : PlaybackStateCompat.ActionPlay))
            .AddAction(Resource.Drawable.ic_next, "下一首", MediaButtonReceiver.BuildMediaButtonPendingIntent(Android.App.Application.Context, PlaybackStateCompat.ActionSkipToNext));

        // 启动前台服务（避免后台播放时被系统回收）
        var serviceIntent = new Intent(Android.App.Application.Context, typeof(MediaPlaybackService));
        if (Build.VERSION.SdkInt >= BuildVersionCodes.O)
        {
            Android.App.Application.Context.StartForegroundService(serviceIntent);
        }
        else
        {
            Android.App.Application.Context.StartService(serviceIntent);
        }

        _notificationManager.Notify(NotificationId, notificationBuilder.Build());
        _mediaSession.Active = true;
    }

    // 释放资源
    public void Release()
    {
        _mediaSession.Active = false;
        _mediaSession.Release();
        _notificationManager.Cancel(NotificationId);
    }

    // 处理系统控件点击回调
    private class MediaSessionCallback : MediaSessionCompat.Callback
    {
        public override void OnPlay() => MessagingCenter.Send<object>(new object(), "PlayCommand");
        public override void OnPause() => MessagingCenter.Send<object>(new object(), "PauseCommand");
        public override void OnSkipToNext() => MessagingCenter.Send<object>(new object(), "NextCommand");
        public override void OnSkipToPrevious() => MessagingCenter.Send<object>(new object(), "PreviousCommand");
    }
}

2. 实现前台服务（后台播放必备） #

在Platforms/Android目录下新建MediaPlaybackService.cs：

using Android.App;
using Android.Content;
using Android.OS;

namespace YourAppName.Platforms.Android;

[Service]
public class MediaPlaybackService : Service
{
    public override IBinder OnBind(Intent intent) => null;

    public override StartCommandResult OnStartCommand(Intent intent, StartCommandFlags flags, int startId)
    {
        // 可在此关联MediaSessionManager，或直接管理会话生命周期
        return StartCommandResult.Sticky;
    }
}

3. MAUI共享代码关联控制逻辑 #

在页面/ViewModel中订阅跨组件消息，控制MediaElement并同步状态：

public MainPage()
{
    InitializeComponent();

    // 订阅系统控件命令
    MessagingCenter.Subscribe<object>(this, "PlayCommand", _ => mediaElement.Play());
    MessagingCenter.Subscribe<object>(this, "PauseCommand", _ => mediaElement.Pause());
    MessagingCenter.Subscribe<object>(this, "NextCommand", _ => 
    {
        // 实现快进/下一曲逻辑
    });
    MessagingCenter.Subscribe<object>(this, "PreviousCommand", _ => 
    {
        // 实现快退/上一曲逻辑
    });

    // 监听播放状态变化，同步到系统通知
    mediaElement.PlaybackStateChanged += (_, e) =>
    {
        if (DeviceInfo.Platform != DevicePlatform.Android) return;
        
        var sessionManager = new Platforms.Android.MediaSessionManager(Android.App.Application.Context);
        sessionManager.UpdatePlaybackState(
            e.NewState == MediaElementState.Playing,
            (long)mediaElement.Position.TotalMilliseconds,
            (long)mediaElement.Duration.TotalMilliseconds
        );
    };
}

4. 添加权限配置 #

在Platforms/Android/AndroidManifest.xml中加入必要权限：

<uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
<uses-permission android:name="android.permission.WAKE_LOCK" /> <!-- 可选，防止播放时设备休眠 -->

关键注意事项 #

• 资源准备：需在Android项目Resources/Drawable目录添加播放、暂停等图标资源（如ic_play.png）。
• 通信替代方案：若不想用MessagingCenter，可通过依赖注入实现IPlatformMediaService接口，避免内存泄漏。
• 后台播放限制：Android 12+对后台启动服务有严格限制，需确保用户主动触发播放后再启动前台服务。

内容的提问来源于stack exchange，提问作者Oliver Posa