MAUI怎么播放音频和视频 MAUI多媒体播放方法

小静姑娘_1545

小静姑娘_1545

2026-02-01

643人浏览

原创

推荐使用 MediaElement(适合带 UI 的音视频播放)或 Plugin.Maui.Audio(专注轻量音频,如提示音、BGM);前者基于原生播放器、支持丰富控件与格式,后者启动快、支持后台播放与低延迟场景。

maui怎么播放音频和视频 maui多媒体播放方法

在 .NET MAUI 中播放音频和视频,目前主流且推荐的方式是使用 MediaElement(来自 Community Toolkit)或 Plugin.Maui.Audio 插件,两者适用场景略有不同:MediaElement 更适合音视频混合、带 UI 控件(如进度条、音量滑块)、需跨平台一致视觉体验的场景;Plugin.Maui.Audio 则更轻量、专注音频(尤其短提示音、背景音乐),启动快、资源占用低,且支持后台播放等高级能力。

用 MediaElement 播放音视频(推荐用于带界面的播放器)

MediaElement 是 MAUI Community Toolkit 提供的原生风格控件,基于各平台原生播放器(Android 用 ExoPlayer,iOS 用 AVPlayer,Windows 用 WinUI MediaPlayerElement),支持 MP4、MP3、HLS 流等常见格式。

  • 安装 NuGet 包:CommunityToolkit.Maui 和 CommunityToolkit.Maui.MediaElement
  • 在 MauiProgram.cs 中启用:
    .UseMauiCommunityToolkitMediaElement()(注意放在 .UseMauiApp() 之后)
  • XAML 中直接使用(支持嵌入资源、本地文件、网络 URL):

  • 绑定常用属性(如音量、位置、状态)需配合 MVVM 或手动刷新 UI,例如:
    Volume="{Binding Volume}"、Position="{Binding Position}"、CurrentState 可读取播放状态(Playing、Paused、Stopped 等)

用 Plugin.Maui.Audio 播放纯音频(推荐用于提示音、BGM、低延迟场景)

这个插件专为音频优化,不依赖 UI 控件,更适合无界面触发、频繁启停、后台持续播放等需求,比如通知音效、游戏音效、语音播报。

  • 安装 NuGet:Plugin.Maui.Audio
  • 在 MauiProgram.cs 初始化:.UseMauiAudio()
  • C# 中播放(支持 app 包内资源、沙盒文件、流):
    var player = _audioManager.CreatePlayer(await FileSystem.OpenAppPackageFileAsync("beep.mp3"));
    player.Play();
  • 支持音量调节、循环播放、暂停/恢复、完成事件监听,且自动管理生命周期,避免内存泄漏

关键注意事项和常见问题

实际开发中容易踩坑的点:

Windows 开机自启并隐藏到系统托盘
Windows 开机自启并隐藏到系统托盘

让 Windows 桌面程序在开机时静默自启并隐藏到系统托盘。特别适用于 Flutter、Electron 等无视 VBS/ProcessStartInfo 窗口样式、难以隐藏的顽固应用。提供「VBS 启动器 + Python ctypes/Win32 API」的隐藏窗口方案,可稳定把窗口收进托盘且不闪控制台。

下载
  • 资源路径写法:嵌入式资源要用 embed://xxx.mp3,不是 res:// 或相对路径;确保资源 Build Action 设为 MauiAsset
  • Android 权限:播放网络视频需在 AndroidManifest.xml 添加 INTERNET 权限;若用本地文件还需 READ_EXTERNAL_STORAGE(API 33+ 需适配分区存储)
  • 自动播放限制:iOS 和部分 Android 浏览器策略禁止静音外自动播放,建议首次交互(如按钮点击)后再调用 Play()
  • 状态监听不可靠?:MediaElement 的 CurrentState 属性不是实时通知,需订阅 StateChanged 事件或定时轮询(推荐事件方式)

简单选择建议

做音乐播放器或带控制栏的视频页 → 选 MediaElement;
仅需播放提示音、语音反馈、后台 BGM → 选 Plugin.Maui.Audio;
需要同时兼顾二者?可共存 —— 用 MediaElement 做主视频,用 Audio 插件播 UI 音效,互不干扰。

基本上就这些。两种方案都已稳定用于生产环境,文档和示例丰富,上手不难但细节容易忽略。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
pdf怎么转换成xml格式
pdf怎么转换成xml格式

将 pdf 转换为 xml 的方法:1. 使用在线转换器;2. 使用桌面软件(如 adobe acrobat、itext);3. 使用命令行工具(如 pdftoxml)。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.04.01

5204

5

xml怎么变成word
xml怎么变成word

步骤:1. 导入 xml 文件;2. 选择 xml 结构;3. 映射 xml 元素到 word 元素;4. 生成 word 文档。提示:确保 xml 文件结构良好,并预览 word 文档以验证转换是否成功。想了解更多xml的相关内容,可以阅读本专题下面的文章。

2024.08.01

6777

7

xml是什么格式的文件
xml是什么格式的文件

xml是一种纯文本格式的文件。xml指的是可扩展标记语言,标准通用标记语言的子集,是一种用于标记电子文件使其具有结构性的标记语言。想了解更多相关的内容,可阅读本专题下面的相关文章。

2024.11.28

2662

7

CSS position定位有几种方式
CSS position定位有几种方式

有4种,分别是静态定位、相对定位、绝对定位和固定定位。更多关于CSS position定位有几种方式的内容,可以访问下面的文章。

2023.11.23

352

4

windows查看端口占用情况
windows查看端口占用情况

Windows端口可以认为是计算机与外界通讯交流的出入口。逻辑意义上的端口一般是指TCP/IP协议中的端口,端口号的范围从0到65535,比如用于浏览网页服务的80端口,用于FTP服务的21端口等等。怎么查看windows端口占用情况呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.07.26

3519

3

查看端口占用情况windows
查看端口占用情况windows

端口占用是指与端口关联的软件占用端口而使得其他应用程序无法使用这些端口,端口占用问题是计算机系统编程领域的一个常见问题,端口占用的根本原因可能是操作系统的一些错误,服务器也可能会出现端口占用问题。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.07.27

3058

6

windows照片无法显示
windows照片无法显示

当我们尝试打开一张图片时,可能会出现一个错误提示,提示说"Windows照片查看器无法显示此图片,因为计算机上的可用内存不足",本专题为大家提供windows照片无法显示相关的文章,帮助大家解决该问题。

2023.08.01

1568

3

windows查看端口被占用的情况
windows查看端口被占用的情况

windows查看端口被占用的情况的方法:1、使用Windows自带的资源监视器;2、使用命令提示符查看端口信息;3、使用任务管理器查看占用端口的进程。本专题为大家提供windows查看端口被占用的情况的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

2779

5

windows无法访问共享电脑
windows无法访问共享电脑

在现代社会中,共享电脑是办公室和家庭的重要组成部分。然而,有时我们可能会遇到Windows无法访问共享电脑的问题。这个问题可能会导致数据无法共享,影响工作和生活的正常进行。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.08

3370

4

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Excel 教程
Excel 教程

共162课时 | 45.8万人学习

Java 教程
Java 教程

共578课时 | 199.8万人学习

Uniapp从零开始实现新闻资讯应用
Uniapp从零开始实现新闻资讯应用

共64课时 | 9.8万人学习