画板

在运行时选择要渲染的画板。

Compose

默认情况下，Rive 可组合项会选中并创建在 Rive 编辑器中指定的默认画板。要指定其他画板，你首先需要从已加载的 RiveFile 创建一个 Artboard 对象。

在 Compose 中，可以使用 rememberArtboard 函数创建 Artboard 对象，该函数接收一个 Rive 文件和画板名称。

val artboard = rememberArtboard(myRiveFile, "My Artboard")

在 Compose 之外

或者，你可以在 Compose 上下文之外创建画板。请注意，使用此方法时，你需要负责管理画板的生命周期，并在不再需要时使用 Artboard::close() 关闭它，或者利用其 AutoClosable 接口配合 use 代码块。

val artboard = Artboard.fromFile(myRiveFile, "My Artboard")
...
artboard.close()

使用画板

获得画板后，你可以通过 artboard 参数将其传递给 Rive 可组合项。

setContent {
    Rive(
        myRiveFile,
        artboard = artboard
    )
}

Legacy

使用 XML 布局

<app.rive.runtime.kotlin.RiveAnimationView
    app:riveResource="@raw/my_rive_file"
    app:riveArtboard="My Artboard"
    app:riveAutoPlay="true" />

使用 Kotlin

animationView.setRiveResource(
    R.raw.my_rive_file,
    artboardName = "My Artboard",
    autoplay = true
)