Android Studio嵌入YouTube视频报错，如何正确使用第三方YouTube播放器依赖？

一、正确集成与使用步骤 #

1. 添加依赖 #

确保Module级build.gradle中引入正确的依赖，之后执行Sync Project with Gradle Files完成同步：

implementation 'com.pierfrancescosoffritti.androidyoutubeplayer:core:12.0.0'

2. 配置权限 #

在AndroidManifest.xml的<application>标签外添加网络权限（已添加的话确认位置正确）：

<uses-permission android:name="android.permission.INTERNET" />

3. 布局文件优化 #

移除布局中tools:ignore="MissingClass,MissingConstraints"标记（依赖同步完成后该警告会自动消失），同时给播放器设置合理的高度（避免用wrap_content导致渲染异常），如果使用ConstraintLayout要补全约束：

<com.pierfrancescosoffritti.androidyoutubeplayer.core.player.views.YouTubePlayerView
    android:id="@+id/youtubeplayerid"
    android:layout_width="match_parent"
    android:layout_height="250dp"
    app:layout_constraintTop_toTopOf="parent"
    app:layout_constraintStart_toStartOf="parent"
    app:layout_constraintEnd_toEndOf="parent"
    android:layout_margin="16dp"/>

4. 代码实现与生命周期管理 #

必须管理播放器的生命周期，避免播放异常或内存泄漏，完整代码如下：

import android.os.Bundle;
import androidx.appcompat.app.AppCompatActivity;
import com.pierfrancescosoffritti.androidyoutubeplayer.core.player.YouTubePlayer;
import com.pierfrancescosoffritti.androidyoutubeplayer.core.player.listeners.AbstractYouTubePlayerListener;
import com.pierfrancescosoffritti.androidyoutubeplayer.core.player.views.YouTubePlayerView;

public class MainActivity extends AppCompatActivity {
    private YouTubePlayerView youTubePlayerView;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        youTubePlayerView = findViewById(R.id.youtubeplayerid);
        youTubePlayerView.enableAutomaticInitialization();

        youTubePlayerView.addYouTubePlayerListener(new AbstractYouTubePlayerListener() {
            @Override
            public void onReady(@NonNull YouTubePlayer youTubePlayer) {
                String videoId = "fis26HvvDII";
                // cueVideo仅加载视频元数据不自动播放，loadVideo会直接启动播放
                youTubePlayer.loadVideo(videoId, 0);
            }
        });
    }

    @Override
    protected void onResume() {
        super.onResume();
        youTubePlayerView.onResume();
    }

    @Override
    protected void onPause() {
        super.onPause();
        youTubePlayerView.onPause();
    }

    @Override
    protected void onDestroy() {
        super.onDestroy();
        youTubePlayerView.release();
    }
}

二、常见报错排查 #

• MissingClass错误：执行File -> Sync Project with Gradle Files同步依赖，若仍报错则清理缓存：File -> Invalidate Caches... -> Invalidate and Restart。
• 视频无法加载/播放：检查设备网络是否正常、视频ID是否有效（视频未被删除/设为私有）。
• 播放器显示异常：避免用wrap_content作为高度，设置固定高度或通过约束布局限制尺寸。

三、关键注意事项 #

• 必须重写onResume()、onPause()、onDestroy()方法，调用播放器对应生命周期方法，否则会引发播放异常和内存泄漏。
• 区分cueVideo()和loadVideo()：前者仅预加载视频，后者会自动播放。
• 建议使用官方最新稳定版依赖，可根据版本更新调整依赖号。

内容的提问来源于stack exchange，提问作者Sabiha Jahan Easha