播放音频

概览

Rive 支持通过音频事件播放音频。音频可以嵌入在 Rive 文件中，也可以作为引用资源加载。

⚠️ 警告：此功能目前仅支持旧版运行时。

⚠️ 警告：Web 平台上的音频播放可能需要用户交互才能开始。在移动端和桌面端，音频播放通常会在加载后自动开始，具体取决于平台限制。

嵌入式资源

嵌入式音频资源包含在 Rive 文件中，无需额外设置即可自动播放。

引用资源

引用音频资源需要应用在运行时提供音频数据。有关更多信息，请参见加载资源。

音频设置

在 iOS 上，播放音频将遵循你的 AVAudioSession 共享实例设置。有关更多信息，请参见 Apple 关于 AVAudioSession 的文档。使用此功能，你可以选择混合音频、降低其他音频等。你可以在应用生命周期的早期更新共享实例，以确保所有 Rive 音频以正确的设置播放。

// 示例：忽略静音开关，并与其他音频混合
let category: AVAudioSession.Category = .playback
let options: AVAudioSession.CategoryOptions = [.mixWithOthers]
AVAudioSession.sharedInstance().setCategory(category, options: options)

设置音量

画板可以设置其音量。父画板将设置所有组件实例的音量；但是，设置组件的音量不会更新父画板的音量。

// 将当前画板的音量设置为 50%
let viewModel = RiveViewModel(fileName: "my_rive_file")
viewModel.riveModel?.volume = 0.5