【亲测免费】 Android YouTube Player 开源项目教程

2026-01-17 08:32:34作者：董灵辛Dennis

项目介绍

android-youtube-player 是一个稳定且可定制的开源 YouTube 播放器，适用于 Android 平台。该项目提供了一个简单的视图，可以轻松集成到任何 Activity 或 Fragment 中。该库是围绕 IFrame Player API 的封装，运行在 WebView 内部，因此不存在违反 YouTube 服务条款的问题。此外，该库还提供了一个 Chromecast YouTube 播放器，可用于投射视频。

项目快速启动

添加依赖

首先，在您的 build.gradle 文件中添加以下依赖：

dependencies {
    implementation 'com.pierfrancescosoffritti.androidyoutubeplayer:core:12.0.0'
}

布局文件

在您的布局文件中添加 YouTubePlayerView：

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical">

    <com.pierfrancescosoffritti.androidyoutubeplayer.core.player.views.YouTubePlayerView
        android:id="@+id/youtube_player_view"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        app:videoId="S0Q4gqBUs7c"
        app:autoPlay="true" />
</LinearLayout>

代码集成

在您的 Activity 或 Fragment 中初始化 YouTubePlayerView 并将其添加为生命周期观察者：

import com.pierfrancescosoffritti.androidyoutubeplayer.core.player.views.YouTubePlayerView;

public class MainActivity extends AppCompatActivity {
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        YouTubePlayerView youTubePlayerView = findViewById(R.id.youtube_player_view);
        getLifecycle().addObserver(youTubePlayerView);
    }
}

应用案例和最佳实践

自定义播放器控件

您可以通过添加自定义控件来增强播放器功能。例如，添加一个 YouTubePlayerSeekBar 来显示和控制播放时间：

<com.pierfrancescosoffritti.androidyoutubeplayer.core.ui.views.YouTubePlayerSeekBar
    android:id="@+id/youtube_player_seekbar"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    app:fontSize="12sp"
    app:color="@color/red" />

在代码中添加监听器：

YouTubePlayerSeekBar youTubePlayerSeekBar = findViewById(R.id.youtube_player_seekbar);
youTubePlayer.addListener(youTubePlayerSeekBar);

投射视频到 Chromecast

使用 Chromecast 功能将视频投射到大屏幕上：

import com.pierfrancescosoffritti.androidyoutubeplayer.chromecast.chromecastsender.ChromecastYouTubePlayerContext;
import com.pierfrancescosoffritti.androidyoutubeplayer.chromecast.chromecastsender.io.infrastructure.ChromecastConnectionListener;

ChromecastConnectionListener chromecastConnectionListener = new ChromecastConnectionListener() {
    @Override
    public void onChromecastConnected(@NonNull ChromecastYouTubePlayerContext chromecastYouTubePlayerContext) {
        // 连接成功后的操作
    }

    @Override
    public void onChromecastDisconnected() {
        // 断开连接后的操作
    }
};

ChromecastYouTubePlayerContext chromecastYouTubePlayerContext = new ChromecastYouTubePlayerContext(chromecastConnectionListener);