Xamarin Forms安卓端添加YouTube自动播放切换播放器需求问询

针对你的需求——Xamarin Forms Android端实现支持播放/暂停、自动播放、无缝切换下一个视频的YouTube播放器，WebView确实无法满足（自动播放限制、切换延迟），我推荐使用自定义渲染器结合Google官方YouTube Android Player API的方案，完美适配Xamarin Forms，且能实现你要的所有功能。

核心思路 #

通过Xamarin Forms的自定义渲染器，将原生Android的YouTube播放器封装成Forms可调用的控件，这样既能利用原生播放器的完整功能（自动播放、视频结束回调），又能在Forms层统一管理UI和业务逻辑。

步骤1：准备工作 #

1. 获取YouTube API密钥：
   • 登录Google开发者控制台，创建项目并启用「YouTube Android Player API」。
   • 生成API密钥，并配置包名和SHA-1指纹（避免密钥被滥用）。
2. 安装NuGet包：
   在Android项目中安装Xamarin.GooglePlayServices.YouTubePlayer包，这是官方原生库的Xamarin绑定版本。

步骤2：在Forms项目中定义抽象播放器控件 #

先创建一个Forms层的自定义View，用来暴露播放、暂停、加载视频的方法和事件，方便后续绑定和调用：

using Xamarin.Forms;

namespace YourAppName
{
    public class YouTubePlayerView : View
    {
        // 视频ID绑定属性
        public static readonly BindableProperty VideoIdProperty = BindableProperty.Create(
            nameof(VideoId),
            typeof(string),
            typeof(YouTubePlayerView),
            string.Empty,
            propertyChanged: OnVideoIdChanged);

        // 播放状态绑定属性
        public static readonly BindableProperty IsPlayingProperty = BindableProperty.Create(
            nameof(IsPlaying),
            typeof(bool),
            typeof(YouTubePlayerView),
            false);

        public string VideoId
        {
            get => (string)GetValue(VideoIdProperty);
            set => SetValue(VideoIdProperty, value);
        }

        public bool IsPlaying
        {
            get => (bool)GetValue(IsPlayingProperty);
            set => SetValue(IsPlayingProperty, value);
        }

        // 视频结束事件（用于自动切换下一个）
        public event EventHandler VideoEnded;
        // 视频加载完成事件
        public event EventHandler<string> VideoLoaded;

        public void Play() => IsPlaying = true;
        public void Pause() => IsPlaying = false;
        public void LoadVideo(string videoId) => VideoId = videoId;

        private static void OnVideoIdChanged(BindableObject bindable, object oldValue, object newValue)
        {
            if (bindable is YouTubePlayerView player)
            {
                player.VideoLoaded?.Invoke(player, newValue.ToString());
            }
        }
    }
}

步骤3：Android项目实现自定义渲染器 #

在Android项目中创建渲染器，将Forms的YouTubePlayerView映射到原生的YouTubePlayerView，并处理播放控制、视频切换和自动播放逻辑：

using Android.Content;
using Xamarin.Forms;
using Xamarin.Forms.Platform.Android;
using YourAppName;
using YourAppName.Droid;
using YouTubePlayer = Android.Gms.YouTube.YouTubePlayerView;

[assembly: ExportRenderer(typeof(YouTubePlayerView), typeof(YouTubePlayerRenderer))]
namespace YourAppName.Droid
{
    public class YouTubePlayerRenderer : ViewRenderer<YouTubePlayerView, YouTubePlayer>, IYouTubePlayerOnInitializedListener
    {
        // 替换成你自己的YouTube API密钥
        private const string ApiKey = "YOUR_YOUTUBE_API_KEY_HERE";
        private Android.Gms.YouTube.YouTubePlayer _nativePlayer;
        private string _currentVideoId;

        public YouTubePlayerRenderer(Context context) : base(context) { }

        protected override void OnElementChanged(ElementChangedEventArgs<YouTubePlayerView> e)
        {
            base.OnElementChanged(e);

            if (Control == null)
            {
                // 创建原生播放器控件
                var nativePlayerView = new YouTubePlayer(Context);
                SetNativeControl(nativePlayerView);
                // 初始化播放器
                nativePlayerView.Initialize(ApiKey, this);
            }

            // 绑定Forms控件的事件和属性变化
            if (e.NewElement != null)
            {
                e.NewElement.VideoLoaded += OnVideoLoaded;
                e.NewElement.PropertyChanged += OnElementPropertyChanged;
            }

            if (e.OldElement != null)
            {
                e.OldElement.VideoLoaded -= OnVideoLoaded;
                e.OldElement.PropertyChanged -= OnElementPropertyChanged;
            }
        }

        // 播放器初始化成功回调
        public void OnInitializationSuccess(IYouTubePlayerProvider provider, Android.Gms.YouTube.YouTubePlayer player, bool wasRestored)
        {
            _nativePlayer = player;
            // 设置播放器样式（ChromeLess无默认控制栏，适合自定义UI；也可以用Default）
            _nativePlayer.SetPlayerStyle(YouTubePlayerStyle.ChromeLess);
            // 监听播放器状态（比如视频结束）
            _nativePlayer.SetPlayerStateChangeListener(new PlayerStateListener(Element));

            // 如果不是恢复状态且有视频ID，直接加载
            if (!wasRestored && !string.IsNullOrEmpty(Element.VideoId))
            {
                LoadVideo(Element.VideoId);
            }
        }

        // 初始化失败回调
        public void OnInitializationFailure(IYouTubePlayerProvider provider, YouTubeInitializationResult errorReason)
        {
            System.Diagnostics.Debug.WriteLine($"YouTube播放器初始化失败: {errorReason.Message}");
        }

        // 处理Forms控件的视频加载事件
        private void OnVideoLoaded(object sender, string videoId)
        {
            LoadVideo(videoId);
        }

        // 处理Forms控件的属性变化（比如播放/暂停）
        private void OnElementPropertyChanged(object sender, System.ComponentModel.PropertyChangedEventArgs e)
        {
            if (e.PropertyName == YouTubePlayerView.IsPlayingProperty.PropertyName)
            {
                if (Element.IsPlaying)
                {
                    _nativePlayer?.Play();
                }
                else
                {
                    _nativePlayer?.Pause();
                }
            }
        }

        // 加载指定视频ID的视频，支持自动播放
        private void LoadVideo(string videoId)
        {
            if (_nativePlayer == null) return;

            _currentVideoId = videoId;
            // 从0秒开始加载视频，加载完成后自动播放（根据IsPlaying状态）
            _nativePlayer.LoadVideo(videoId, 0);
            if (Element.IsPlaying)
            {
                _nativePlayer.Play();
            }
        }

        // 播放器状态监听类，用来捕获视频结束事件
        private class PlayerStateListener : Java.Lang.Object, IYouTubePlayerPlayerStateChangeListener
        {
            private readonly YouTubePlayerView _formsPlayer;

            public PlayerStateListener(YouTubePlayerView formsPlayer)
            {
                _formsPlayer = formsPlayer;
            }

            public void OnAdStarted() { }
            public void OnError(YouTubePlayerErrorReason errorReason) { }
            public void OnLoaded(string videoId) { }
            public void OnLoading() { }

            // 视频结束时触发Forms层的VideoEnded事件
            public void OnVideoEnded()
            {
                _formsPlayer.VideoEnded?.Invoke(_formsPlayer, EventArgs.Empty);
            }

            public void OnVideoStarted()
            {
                _formsPlayer.IsPlaying = true;
            }
        }

        // 释放资源
        protected override void Dispose(bool disposing)
        {
            if (disposing)
            {
                _nativePlayer?.Release();
                Element.VideoLoaded -= OnVideoLoaded;
                Element.PropertyChanged -= OnElementPropertyChanged;
            }
            base.Dispose(disposing);
        }
    }
}

步骤4：在Forms页面中使用播放器 #

在XAML或代码中引用自定义播放器，实现播放、暂停、自动切换功能：

XAML示例 #

<ContentPage xmlns="http://xamarin.com/schemas/2014/forms"
             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
             xmlns:local="clr-namespace:YourAppName"
             x:Class="YourAppName.MainPage">

    <StackLayout Margin="20">
        <!-- YouTube播放器控件 -->
        <local:YouTubePlayerView x:Name="YoutubePlayer" 
                                 VideoId="dQw4w9WgXcQ"
                                 IsPlaying="True"
                                 HeightRequest="300"/>

        <!-- 控制按钮 -->
        <Button Text="播放" Clicked="PlayBtn_Clicked" Margin="0,10,0,0"/>
        <Button Text="暂停" Clicked="PauseBtn_Clicked" Margin="0,10,0,0"/>
        <Button Text="切换下一个" Clicked="NextVideoBtn_Clicked" Margin="0,10,0,0"/>
    </StackLayout>
</ContentPage>

后台代码（实现自动切换） #

namespace YourAppName
{
    public partial class MainPage : ContentPage
    {
        // 视频ID列表，按需替换
        private readonly List<string> _videoPlaylist = new List<string>
        {
            "dQw4w9WgXcQ",
            "another-video-id-1",
            "another-video-id-2"
        };
        private int _currentVideoIndex = 0;

        public MainPage()
        {
            InitializeComponent();
            // 监听视频结束事件，自动切换下一个
            YoutubePlayer.VideoEnded += YoutubePlayer_VideoEnded;
        }

        private void PlayBtn_Clicked(object sender, EventArgs e)
        {
            YoutubePlayer.Play();
        }

        private void PauseBtn_Clicked(object sender, EventArgs e)
        {
            YoutubePlayer.Pause();
        }

        private void NextVideoBtn_Clicked(object sender, EventArgs e)
        {
            SwitchToNextVideo();
        }

        // 自动切换下一个视频
        private void YoutubePlayer_VideoEnded(object sender, EventArgs e)
        {
            SwitchToNextVideo();
        }

        private void SwitchToNextVideo()
        {
            _currentVideoIndex = (_currentVideoIndex + 1) % _videoPlaylist.Count;
            YoutubePlayer.LoadVideo(_videoPlaylist[_currentVideoIndex]);
        }
    }
}

解决你之前遇到的问题 #

1. 关于「Xamarin + Android + Binding YouTube video player」编译错误：
   大概率是因为没有正确安装Xamarin.GooglePlayServices.YouTubePlayer NuGet包，或者API密钥未配置/未启用对应的API。本方案使用官方维护的绑定包，稳定性更高。
2. 关于「Youtube player for xamarin forms」仅支持iOS：
   本方案专门针对Android实现，且通过Forms自定义控件可以轻松扩展到iOS（iOS端可以用官方YouTubeKit通过自定义渲染器实现）。
3. 关于2014年的Xamarin Android方案：
   那个方案是纯原生Android的，本方案通过自定义渲染器适配了Xamarin Forms，完美解决跨平台调用的问题。

内容的提问来源于stack exchange，提问作者Sebastian Oscar Lopez