Apple设备本地录制视频无法播放问题（VS调试正常）

录制视频保存至本地后，Visual Studio真机调试时功能正常，但部署到Apple设备后，仅显示MediaElement的红色背景矩形，无视频内容。相关代码如下：

相关代码 #

XAML #

<xct:MediaElement
  BackgroundColor="red"
  x:Name="mediaElement"
  Source="{Binding Video}" 
  ShowsPlaybackControls="True"
  HeightRequest="400"
  HorizontalOptions="Fill"/>

MVVM代码 #

public async void MoveVideo(FileResult fileResult)
{
  var documentsFolder = GetVideoFolderPath();
  var newFile = Path.Combine(documentsFolder, fileResult.FileName);
  using (var stream = await fileResult.OpenReadAsync())
  using (var newStream = File.OpenWrite(newFile))
    await stream.CopyToAsync(newStream);

  var ex = System.IO.File.Exists(Path.Combine(documentsFolder, fileResult.FileName));        // 验证文件存在，返回true
}

public string GetVideoFolderPath()
{
  var documentsFolder = Environment.GetFolderPath(Environment.SpecialFolder.MyDocuments);
  return documentsFolder;
}

private void CheckVideo() {
  var documentsFolder = _videoService.GetVideoFolderPath();
  var pathAndFile = Path.Combine(documentsFolder, LocalFilePath);
  var b = new System.Uri(pathAndFile).AbsolutePath;
  if(File.Exists(pathAndFile)) 
  {
    Video = MediaSource.FromFile(b);
  }
}

解决方法 #

1. 修正iOS文件路径格式 #

iOS平台下，MediaSource.FromFile需要带file://协议头的完整文件URL，直接使用绝对路径字符串会导致系统无法识别文件位置。修改CheckVideo方法：

private void CheckVideo() {
  var documentsFolder = _videoService.GetVideoFolderPath();
  var pathAndFile = Path.Combine(documentsFolder, LocalFilePath);
  if(File.Exists(pathAndFile)) 
  {
    // 构建带file://协议的完整Uri
    var videoUri = new Uri($"file://{pathAndFile}");
    Video = MediaSource.FromUri(videoUri);
  }
}

2. 验证视频文件完整性 #

文件复制过程中可能出现截断，导致视频文件损坏。在MoveVideo方法中添加文件大小校验：

using (var stream = await fileResult.OpenReadAsync())
using (var newStream = File.OpenWrite(newFile))
{
    await stream.CopyToAsync(newStream);
    newStream.Flush(); // 确保写入完成
    // 校验源文件与目标文件大小一致
    if (stream.Length != newFile.Length)
    {
        // 处理复制失败逻辑，比如重新复制或提示用户
    }
}

3. 检查平台配置与组件版本 #

• 确保使用最新版本的.NET MAUI Community Toolkit（原Xamarin.CommunityToolkit），避免版本兼容性问题。
• 检查iOS项目Info.plist，确认没有遗漏必要权限（播放本地视频通常无需额外权限，但录制视频需确保麦克风等权限已配置）。

4. 强制触发视频加载与播放 #

绑定更新后MediaElement可能未自动加载，可在设置Video属性后手动触发播放：

• 若使用代码后台，可直接调用mediaElement.Play();
• 若用MVVM，可添加PlayCommand，在设置Video后执行命令触发播放。

内容的提问来源于stack exchange，提问作者Kasper Sommer