MAUI中iOS平台CollectionView嵌套MediaElement崩溃问题

问题原因 #

iOS 平台下，MediaElement 底层依赖 AVPlayerViewController 实现播放功能。而 CollectionView 的单元格复用机制会导致：当单元格被回收再利用时，旧的 AVPlayerViewController 与原父控制器的关联未正确解除，新的父控制器绑定后出现视图控制器层级不一致，触发 UIViewControllerHierarchyInconsistency 异常。

解决方案 #

方案一：自定义 iOS 处理器，绕过 AVPlayerViewController（推荐） #

直接使用 AVPlayerLayer 嵌入视图，避免涉及视图控制器层级管理，从根源解决冲突问题。

1. 在 iOS 项目中创建自定义处理器：

[assembly: ExportHandler(typeof(MediaElement), typeof(CustomMediaElementHandler))]
namespace YourAppNamespace.iOS.Handlers
{
    public class CustomMediaElementHandler : MediaElementHandler
    {
        private AVPlayer? _player;
        private AVPlayerLayer? _playerLayer;

        protected override void ConnectHandler(MauiMediaElement platformView)
        {
            // 初始化播放器与图层
            _player = new AVPlayer();
            _playerLayer = AVPlayerLayer.FromPlayer(_player);
            _playerLayer.Frame = platformView.Bounds;
            platformView.Layer.AddSublayer(_playerLayer);

            // 绑定播放控制逻辑
            VirtualView.PlayRequested += (_, __) => _player?.Play();
            VirtualView.PauseRequested += (_, __) => _player?.Pause();
            UpdateVideoSource();

            base.ConnectHandler(platformView);
        }

        protected override void DisconnectHandler(MauiMediaElement platformView)
        {
            // 清理资源避免泄漏
            _player?.Pause();
            _player?.ReplaceCurrentItemWithPlayerItem(null);
            _playerLayer?.RemoveFromSuperLayer();
            _player = null;
            _playerLayer = null;

            base.DisconnectHandler(platformView);
        }

        public override void SetValue(BindableProperty property, object value)
        {
            base.SetValue(property, value);
            if (property == MediaElement.SourceProperty)
            {
                UpdateVideoSource();
            }
        }

        private void UpdateVideoSource()
        {
            if (_player == null || VirtualView.Source is not Uri uri) return;
            
            var asset = AVAsset.FromUrl(NSUrl.FromString(uri.AbsoluteUri));
            var playerItem = AVPlayerItem.FromAsset(asset);
            _player.ReplaceCurrentItemWithPlayerItem(playerItem);
        }
    }
}

2. 清理项目并重新编译，自定义处理器会自动替换默认实现。

方案二：禁用单元格复用（临时方案） #

适合视频数量较少的场景，直接关闭 CollectionView 的复用机制，避免单元格回收导致的层级冲突：

<CollectionView ItemsSource="{Binding VideoList}" DisableRecycling="True">
    <CollectionView.ItemTemplate>
        <DataTemplate>
            <MediaElement Source="{Binding Url}" AutoPlay="False" />
        </DataTemplate>
    </CollectionView.ItemTemplate>
</CollectionView>

⚠️ 注意：该方案会大幅增加内存占用，不适合大量视频展示场景。

方案三：单元格绑定变更时手动清理层级关联 #

创建自定义单元格，在绑定上下文变更时强制清理旧的 AVPlayerViewController 关联：

1. 定义自定义单元格：

<ContentView xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
             x:Class="YourAppNamespace.VideoCell">
    <MediaElement x:Name="Player" AutoPlay="False" />
</ContentView>

2. 在代码后台添加平台特定清理逻辑：

public partial class VideoCell : ContentView
{
    public static readonly BindableProperty VideoUrlProperty =
        BindableProperty.Create(nameof(VideoUrl), typeof(string), typeof(VideoCell), propertyChanged: OnVideoUrlChanged);

    public string VideoUrl
    {
        get => (string)GetValue(VideoUrlProperty);
        set => SetValue(VideoUrlProperty, value);
    }

    public VideoCell()
    {
        InitializeComponent();
        BindingContextChanged += OnBindingContextChanged;
    }

    private void OnBindingContextChanged(object sender, EventArgs e)
    {
        CleanupPlayerHierarchy();
    }

    private static void OnVideoUrlChanged(BindableObject bindable, object oldValue, object newValue)
    {
        var cell = bindable as VideoCell;
        cell?.CleanupPlayerHierarchy();
        cell?.Player.Source = string.IsNullOrEmpty(newValue as string) ? null : new Uri(newValue.ToString());
    }

    private void CleanupPlayerHierarchy()
    {
#if IOS
        var handler = Player.Handler as MediaElementHandler;
        if (handler?.PlatformView == null) return;

        var avPlayerVC = handler.PlatformView.Superview?.NextResponder as AVPlayerViewController;
        if (avPlayerVC != null)
        {
            avPlayerVC.WillMoveToParentViewController(null);
            avPlayerVC.RemoveFromParentViewController();
            avPlayerVC.View.RemoveFromSuperview();
        }
#endif
    }
}

3. 在 CollectionView 中使用自定义单元格：

<CollectionView ItemsSource="{Binding VideoList}">
    <CollectionView.ItemTemplate>
        <DataTemplate>
            <local:VideoCell VideoUrl="{Binding Url}" />
        </DataTemplate>
    </CollectionView.ItemTemplate>
</CollectionView>

内容的提问来源于stack exchange，提问作者Monil Gandhi