Xamarin UWP集成MediaManager.Forms触发NotImplementedException
Plugin.MediaManager.Forms UWP 抛出 NotImplementedException 问题排查
异常本质
你碰到的System.NotImplementedException 和UWP项目的权限、能力配置没有任何关系,根因是当前用的Plugin.MediaManager.Forms 1.0.7版本本身压根没做完UWP平台的适配。
- 1.0.7这个正式版发布的时候,开发团队只把Android、iOS端的全链路播放逻辑写完了,UWP的适配层还停留在代码占位阶段:所有和播放相关的核心方法(初始化播放器、加载媒体源、同步播放状态、关联后台媒体控制)里,直接写了抛
NotImplementedException的占位标记,根本没有可运行的实际逻辑。 - 你在Android、iOS上跑着完全正常,是因为这俩平台的代码是写完了的,和权限配置没关系;就算给UWP项目把所有能加的权限、能力全勾上,只要一调用播放接口,就会直接触发占位异常把应用崩掉。
解决步骤
- 升级到支持UWP的版本线
- 1.0.7是UWP适配做完之前的最后一个正式稳定版,从
1.1.0-beta开始,开发团队才把UWP端的所有实现补全,后续的正式版本都能完整支持UWP的前台播放、后台媒体控制能力。 - 你现在用的
Xamarin.Forms 4.8.0.1821和1.1.0及以上的MediaManager版本是完全兼容的,不需要额外升级Xamarin.Forms的依赖。
- 1.0.7是UWP适配做完之前的最后一个正式稳定版,从
- 补全UWP端的专属依赖和初始化
- 1.0.7之后的版本把跨平台共享包和平台专属包做了拆分,UWP项目不能只装共享的
Plugin.MediaManager.Forms包,必须单独安装对应版本的Plugin.MediaManager.UWPNuget依赖,不然会出现找不到实现类、自动初始化失败的问题。 - 在UWP项目的
App.xaml.cs启动方法里,手动注册MediaManager实例,别全靠Forms组件的自动初始化:protected override void OnLaunched(LaunchActivatedEventArgs e) { // 原有页面初始化逻辑保留 // ... // 手动绑定UWP端的媒体管理器实现 CrossMediaManager.Current = new MediaManagerImplementation(); // 关联系统媒体传输控件,支持锁屏、后台场景的播放控制 SystemMediaTransportControls.GetForCurrentView().ButtonPressed += CrossMediaManager.Current.PlaybackControls.ButtonPressed; }
- 1.0.7之后的版本把跨平台共享包和平台专属包做了拆分,UWP项目不能只装共享的
- 权限配置核对
你已经在Package.appxmanifest里勾的“后台媒体播放”“Internet”“音乐库”“视频库”权限,已经完全满足UWP端音频播放的要求,不需要再加其他配置。
内容的提问来源于stack exchange,提问作者Sreejith Sree
相关产品推荐
相关产品推荐

