如何在Jetpack Compose中借助AndroidView集成自定义Activity？

首先明确核心限制：AndroidView组件仅支持嵌入Android View，无法直接集成Activity。Activity是独立的页面组件，拥有自己的生命周期栈，不能嵌入Compose界面。正确的做法是将自定义Activity中的业务逻辑、状态管理剥离到可复用的View组件中，再通过AndroidView集成到Compose。

实现步骤 #

1. 剥离自定义Activity的核心逻辑到View组件 #

以BrightcovePlayer为例，我们不需要继承BrightcovePlayerActivity，而是直接基于Brightcove提供的BrightcoveExoPlayerVideoView封装自定义View，将原Activity中的播放器初始化、状态管理逻辑迁移过来：

class BrightcovePlayerWrapperView @JvmOverloads constructor(
    context: Context,
    attrs: AttributeSet? = null,
    defStyleAttr: Int = 0
) : FrameLayout(context, attrs, defStyleAttr) {

    private lateinit var brightcovePlayer: BrightcovePlayer
    private lateinit var videoView: BrightcoveExoPlayerVideoView

    init {
        // 加载布局（包含Brightcove的VideoView）
        inflate(context, R.layout.brightcove_player_wrapper, this)
        setupPlayer()
    }

    private fun setupPlayer() {
        videoView = findViewById(R.id.brightcove_video_view)
        brightcovePlayer = BrightcovePlayer(context).apply {
            this.videoView = this@BrightcovePlayerWrapperView.videoView
            // 初始化Brightcove账号信息
            account = "YOUR_BRIGHTCOVE_ACCOUNT_ID"
            policy = "YOUR_BRIGHTCOVE_POLICY_KEY"
        }
    }

    // 对外暴露操作方法
    fun loadVideo(videoId: String) {
        val catalog = Catalog(brightcovePlayer.account, brightcovePlayer.policy)
        catalog.findVideoByID(videoId) { video, error ->
            if (error == null && video != null) {
                videoView.add(video)
                videoView.start()
            }
        }
    }

    fun pausePlayback() = videoView.pause()
    fun resumePlayback() = videoView.start()
    fun releasePlayer() {
        videoView.stopPlayback()
        brightcovePlayer.release()
    }
}

对应的布局文件res/layout/brightcove_player_wrapper.xml：

<?xml version="1.0" encoding="utf-8"?>
<FrameLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent">

    <com.brightcove.player.view.BrightcoveExoPlayerVideoView
        android:id="@+id/brightcove_video_view"
        android:layout_width="match_parent"
        android:layout_height="match_parent" />

</FrameLayout>

2. 在Compose中通过AndroidView集成自定义View #

使用AndroidView创建并管理自定义View的实例，配合ViewModel处理状态，同时绑定生命周期：

第一步：创建ViewModel管理播放器状态

class PlayerViewModel : ViewModel() {
    private val _currentVideoId = MutableStateFlow("")
    val currentVideoId = _currentVideoId.asStateFlow()

    fun loadVideo(videoId: String) {
        _currentVideoId.value = videoId
    }
}

第二步：Compose界面集成

@Composable
fun PlayerScreen(viewModel: PlayerViewModel = viewModel()) {
    val currentVideoId by viewModel.currentVideoId.collectAsStateWithLifecycle()
    val lifecycleOwner = LocalLifecycleOwner.current

    Column(modifier = Modifier.fillMaxSize()) {
        // 控制按钮
        Button(
            onClick = { viewModel.loadVideo("YOUR_TEST_VIDEO_ID") },
            modifier = Modifier.padding(16.dp)
        ) {
            Text("加载测试视频")
        }

        // 集成自定义播放器View
        AndroidView(
            factory = { context ->
                BrightcovePlayerWrapperView(context).apply {
                    // 初始化时加载默认视频（如果有的话）
                    if (currentVideoId.isNotEmpty()) {
                        loadVideo(currentVideoId)
                    }
                }
            },
            update = { view ->
                // 当视频ID变更时更新播放器
                if (currentVideoId.isNotEmpty()) {
                    view.loadVideo(currentVideoId)
                }
            },
            modifier = Modifier.fillMaxWidth().weight(1f)
        )

        // 绑定生命周期：处理暂停/恢复
        DisposableEffect(lifecycleOwner) {
            val observer = LifecycleEventObserver { _, event ->
                val playerView = AndroidViewScope.currentView as? BrightcovePlayerWrapperView
                when (event) {
                    Lifecycle.Event.ON_RESUME -> playerView?.resumePlayback()
                    Lifecycle.Event.ON_PAUSE -> playerView?.pausePlayback()
                    else -> {}
                }
            }
            lifecycleOwner.lifecycle.addObserver(observer)
            onDispose {
                lifecycleOwner.lifecycle.removeObserver(observer)
            }
        }

        // 组件销毁时释放播放器资源
        DisposableEffect(Unit) {
            onDispose {
                (AndroidViewScope.currentView as? BrightcovePlayerWrapperView)?.releasePlayer()
            }
        }
    }
}

最佳实践 #

• 坚决避免直接嵌入Activity：Activity无法嵌入Compose，强行通过反射或其他hack方式实现会导致生命周期混乱、内存泄漏等问题。
• 状态上移到ViewModel：播放器的核心状态（当前视频、播放进度等）交由ViewModel管理，遵循单向数据流原则，Compose侧仅负责收集状态并更新View。
• 利用DisposableEffect绑定生命周期：通过DisposableEffect处理View的资源释放、生命周期回调绑定，确保与Compose组件的生命周期同步。
• 复用第三方库的View组件：直接基于第三方库提供的View封装，不要重复实现核心功能，减少维护成本。
• 处理配置变更：ViewModel会在屏幕旋转等配置变更时保留状态，避免播放进度、当前视频等信息丢失。
• 避免View持有Compose状态：View仅负责执行具体操作（加载视频、暂停等），状态由Compose侧通过update回调传递，保持职责分离。

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