Android YouTube API：无需继承YouTubeActivity播放视频的替代方案及RecyclerView示例

当然有办法！你完全不用继承YouTubeActivity，可以通过YouTubePlayerView（一个自定义View组件）来嵌入YouTube视频播放，这样就能灵活地在任意布局（包括RecyclerView的item里）使用了。下面我给你详细讲怎么在RecyclerView中实现：

Google的YouTube Android Player SDK提供了YouTubePlayerView，它可以直接放到XML布局中，不需要你的Activity继承特定的基类，只需要在代码中完成初始化和播放逻辑即可。

1. 配置依赖 #

首先在你的app级build.gradle中添加YouTube Player SDK的依赖：

implementation 'com.google.android.youtube:youtube-android-player:10.0.1'

（注：如果有最新版本可以替换，但10.0.1是目前兼容性较好的稳定版本）

2. 创建RecyclerView Item布局 #

新建item_youtube_video.xml，用来定义每个视频项的布局，核心是加入YouTubePlayerView：

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:orientation="vertical"
    android:padding="8dp">

    <com.google.android.youtube.player.YouTubePlayerView
        android:id="@+id/youtube_player_view"
        android:layout_width="match_parent"
        android:layout_height="200dp"/>

    <TextView
        android:id="@+id/tv_video_title"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:layout_marginTop="8dp"
        android:textSize="16sp"
        android:textStyle="bold"/>
</LinearLayout>

3. 定义数据类 #

创建一个简单的数据类来存储视频的ID和标题：

data class VideoItem(val videoId: String, val title: String)

4. 实现RecyclerView Adapter #

Adapter的核心是在ViewHolder中处理YouTubePlayerView的初始化和播放逻辑，同时要注意生命周期管理，避免滑动时多个视频同时播放：

class YouTubeVideoAdapter(private val videoList: List<VideoItem>) : RecyclerView.Adapter<YouTubeVideoAdapter.VideoViewHolder>() {

    inner class VideoViewHolder(itemView: View) : RecyclerView.ViewHolder(itemView), YouTubePlayer.OnInitializedListener {
        private val youtubePlayerView: YouTubePlayerView = itemView.findViewById(R.id.youtube_player_view)
        private val tvTitle: TextView = itemView.findViewById(R.id.tv_video_title)
        private var youtubePlayer: YouTubePlayer? = null

        init {
            // 初始化播放器，替换成你自己的YouTube API Key
            youtubePlayerView.initialize("YOUR_YOUTUBE_API_KEY", this)
        }

        override fun onInitializationSuccess(provider: YouTubePlayer.Provider?, player: YouTubePlayer?, wasRestored: Boolean) {
            youtubePlayer = player
            // 设置播放器样式和基础参数
            player?.setPlayerStyle(YouTubePlayer.PlayerStyle.DEFAULT)
            if (!wasRestored) {
                // 首次初始化时加载当前item的视频
                player?.cueVideo(videoList[adapterPosition].videoId)
            }
        }

        override fun onInitializationFailure(provider: YouTubePlayer.Provider?, errorReason: YouTubeInitializationResult?) {
            // 处理初始化失败的情况，比如弹提示
            Toast.makeText(itemView.context, "播放器初始化失败: ${errorReason?.name}", Toast.LENGTH_SHORT).show()
        }

        fun bind(item: VideoItem) {
            tvTitle.text = item.title
            // 绑定数据时，如果播放器已初始化，更新视频
            youtubePlayer?.cueVideo(item.videoId)
        }

        // 暂停播放器，避免滑动时后台继续播放
        fun pausePlayer() {
            youtubePlayer?.pause()
        }
    }

    override fun onCreateViewHolder(parent: ViewGroup, viewType: Int): VideoViewHolder {
        val view = LayoutInflater.from(parent.context).inflate(R.layout.item_youtube_video, parent, false)
        return VideoViewHolder(view)
    }

    override fun onBindViewHolder(holder: VideoViewHolder, position: Int) {
        holder.bind(videoList[position])
    }

    override fun getItemCount(): Int = videoList.size

    // 当item滑出屏幕时，暂停该item的播放器
    override fun onViewDetachedFromWindow(holder: VideoViewHolder) {
        super.onViewDetachedFromWindow(holder)
        holder.pausePlayer()
    }
}

5. 在Activity中使用RecyclerView #

在你的主Activity（任意普通Activity即可，不需要继承YouTubeActivity）中初始化RecyclerView：

class MainActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)

        val recyclerView: RecyclerView = findViewById(R.id.recycler_view)
        recyclerView.layoutManager = LinearLayoutManager(this)
        
        // 模拟视频数据，替换成你自己的视频ID和标题
        val videoList = listOf(
            VideoItem("dQw4w9WgXcQ", "Rick Astley - Never Gonna Give You Up"),
            VideoItem("9bZkp7q19f0", "PSY - GANGNAM STYLE(강남스타일) M/V"),
            VideoItem("fJ9rUzIMcZQ", "Ed Sheeran - Shape of You (Official Music Video)")
        )
        
        recyclerView.adapter = YouTubeVideoAdapter(videoList)
    }
}

关键注意事项 #

• API Key替换：一定要把代码中的YOUR_YOUTUBE_API_KEY替换成你在Google Cloud Console申请的有效API Key（需要开启YouTube Data API v3）。
• 生命周期管理：如果Activity进入后台，建议遍历RecyclerView的所有ViewHolder，调用pausePlayer()避免耗电；销毁时要释放播放器资源。
• 避免多视频同时播放：除了onViewDetachedFromWindow的处理，还可以监听RecyclerView的滑动事件，只允许当前可见区域的一个视频播放。
• 权限配置：确保在AndroidManifest.xml中添加网络权限：<uses-permission android:name="android.permission.INTERNET"/>

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