Android应用使用Soffritti YouTube Player加载视频出现Error 15

问题描述 #

使用Soffritti Android YouTube Player库（com.pierfrancescosoffritti.androidyoutubeplayer:core:12.1.0）播放YouTube视频时，播放器初始化正常，但加载视频失败，显示错误：Error 15: This video is not available。

代码片段 #

public class YouTubePlayerFragment extends Fragment {

    private YouTubePlayerView youTubePlayerView;
    private String videoId = "NqrhOQRvz0U"; // Example video ID

    @Nullable
    @Override
    public View onCreateView(@NonNull LayoutInflater inflater, @Nullable ViewGroup container,
                             @Nullable Bundle savedInstanceState) {

        View view = inflater.inflate(R.layout.youtube_video_player_fragment, container, false);
        youTubePlayerView = view.findViewById(R.id.youtubePlayerView);

        getLifecycle().addObserver(youTubePlayerView);

        youTubePlayerView.addYouTubePlayerListener(new AbstractYouTubePlayerListener() {
            @Override
            public void onReady(@NonNull YouTubePlayer youTubePlayer) {
                youTubePlayer.loadVideo(videoId, 0f);
            }

            @Override
            public void onError(@NonNull YouTubePlayer youTubePlayer, @NonNull PlayerConstants.PlayerError error) {
                Toast.makeText(requireContext(), "Error: " + error, Toast.LENGTH_LONG).show();
            }
        });

        return view;
    }
}

环境信息 #

解决方案 #

Error 15通常表示视频因版权、地域限制或嵌入权限问题无法播放，以下是针对性解决步骤：

• 检查视频嵌入权限
  访问YouTube视频原页面，点击「分享」→「嵌入」，查看是否有「此视频无法嵌入」的提示。若有，联系视频作者开启嵌入权限，或更换允许嵌入的视频测试。注意：部分视频即使允许公开观看，也可能限制第三方应用嵌入权限。

• 验证地域访问限制
  测试设备当前地区可能无法访问该视频，可使用VPN切换到视频允许播放的地区，或更换无地域限制的YouTube视频（如官方演示视频ID：M7lc1UVf-VE）测试。

• 升级库版本
  当前12.1.0版本可能与高版本WebView（128.x）存在兼容性问题。在build.gradle中更新依赖到最新版本：

  implementation 'com.pierfrancescosoffritti.androidyoutubeplayer:core:最新版本号'
  

  可查看库更新日志确认是否修复了WebView兼容性相关错误。

• 检查网络与WebView配置
  确保设备网络正常，且WebView未禁用JavaScript（该库依赖此功能）。在系统设置中找到WebView设置，确认JavaScript已启用；同时可清除WebView缓存和数据后重新测试。

• 替换加载方法尝试
  在onReady方法中，将youTubePlayer.loadVideo(videoId, 0f);替换为youTubePlayer.cueVideo(videoId, 0f);，cueVideo为预加载视频而非直接播放，部分场景下可规避加载错误。

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