Xamarin转MAUI：运行时添加VideoStreamRendererView遇Handler异常

方案一：为NativeViewWrapper注册Handler #

MAUI抛出HandlerNotFoundException是因为系统找不到NativeViewWrapper对应的处理程序，手动注册即可解决：

1. 在MauiProgram.cs中添加Handler注册逻辑：

using Microsoft.Maui.Controls.Compatibility.Platform.Android;
using Microsoft.Maui.Handlers;

public static class MauiProgram
{
    public static MauiApp CreateMauiApp()
    {
        var builder = MauiApp.CreateBuilder();
        builder
            .UseMauiApp<App>()
            .ConfigureMauiHandlers(handlers =>
            {
                // 注册NativeViewWrapper的自定义Handler
                handlers.AddHandler(typeof(NativeViewWrapper), typeof(NativeViewWrapperHandler));
            });

        // 其他服务注册代码...

        return builder.Build();
    }
}

2. 实现自定义NativeViewWrapperHandler：

using Microsoft.Maui.Handlers;
using Microsoft.Maui.Controls.Compatibility.Platform.Android;

public class NativeViewWrapperHandler : ViewHandler<NativeViewWrapper, Android.Views.View>
{
    protected override Android.Views.View CreatePlatformView()
    {
        // 返回NativeViewWrapper包装的原生View
        return VirtualView.NativeView;
    }

    protected override void ConnectHandler(Android.Views.View platformView)
    {
        base.ConnectHandler(platformView);
        // 可在此添加视图初始化逻辑
    }

    protected override void DisconnectHandler(Android.Views.View platformView)
    {
        // 页面卸载时清理资源，避免内存泄漏
        base.DisconnectHandler(platformView);
    }
}

注册完成后，再调用ToView扩展方法并设置到ContentView.Content，就不会再抛出异常。

方案二：直接通过自定义View嵌入原生控件（更推荐） #

跳过Compatibility层的ToView方法，用MAUI原生Handler体系对接ACS的原生视图，稳定性更强：

1. 共享项目中定义自定义ContentView：

public class ACSVideoContainer : ContentView
{
    // 用于传递原生VideoView实例的绑定属性
    public static readonly BindableProperty NativeVideoViewProperty =
        BindableProperty.Create(nameof(NativeVideoView), typeof(Android.Views.View), typeof(ACSVideoContainer));

    public Android.Views.View NativeVideoView
    {
        get => (Android.Views.View)GetValue(NativeVideoViewProperty);
        set => SetValue(NativeVideoViewProperty, value);
    }
}

2. Android项目中实现对应的Handler：

using Microsoft.Maui.Handlers;
using Azure.Communication.Calling; // 根据ACS实际命名空间调整

public class ACSVideoContainerHandler : ViewHandler<ACSVideoContainer, Android.Views.ViewGroup>
{
    protected override Android.Views.ViewGroup CreatePlatformView()
    {
        return new Android.Widget.FrameLayout(Context);
    }

    protected override void ConnectHandler(Android.Views.ViewGroup platformView)
    {
        base.ConnectHandler(platformView);
        UpdateNativeVideoView();
        // 监听NativeVideoView属性变化
        VirtualView.PropertyChanged += VirtualView_PropertyChanged;
    }

    private void VirtualView_PropertyChanged(object sender, System.ComponentModel.PropertyChangedEventArgs e)
    {
        if (e.PropertyName == ACSVideoContainer.NativeVideoViewProperty.PropertyName)
        {
            UpdateNativeVideoView();
        }
    }

    private void UpdateNativeVideoView()
    {
        if (PlatformView == null) return;
        // 清空容器原有视图
        PlatformView.RemoveAllViews();
        // 添加ACS返回的原生VideoView
        if (VirtualView.NativeVideoView != null)
        {
            PlatformView.AddView(VirtualView.NativeVideoView);
        }
    }

    protected override void DisconnectHandler(Android.Views.ViewGroup platformView)
    {
        VirtualView.PropertyChanged -= VirtualView_PropertyChanged;
        platformView.RemoveAllViews();
        base.DisconnectHandler(platformView);
    }
}

3. 在MauiProgram.cs中注册Handler：

.ConfigureMauiHandlers(handlers =>
{
    handlers.AddHandler(typeof(ACSVideoContainer), typeof(ACSVideoContainerHandler));
})

4. 页面中使用：

// 获取ACS返回的VideoStreamRendererView实例
var nativeVideoView = await acsCallClient.GetVideoRendererView();
// 绑定到自定义容器
myACSVideoContainer.NativeVideoView = nativeVideoView;

注意事项 #

• 操作原生视图时必须确保在UI线程，可用MainThread.BeginInvokeOnMainThread包裹
• 页面卸载时务必清理ACS视频流资源，避免内存泄漏
• 优先使用方案二，减少对Compatibility层的依赖，适配MAUI原生架构

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