属性（Props）

新版 Runtime（推荐）

RiveView 常用属性：

• file（必填，RiveFile）：要渲染的文件
• hybridRef：来自 useRive 的 ref setter
• autoPlay（默认 true）：是否自动播放状态机
• fit（默认 Contain）：适配方式
• alignment（默认 Center）：对齐方式（Fit.Layout 下忽略）
• layoutScaleFactor（默认 -1）：Fit.Layout 的缩放系数
• artboardName：指定 artboard
• stateMachineName：指定 state machine
• dataBind：数据绑定模式或实例
  • DataBindMode.Auto（默认）
  • DataBindMode.None
  • { byName: string }
  • ViewModelInstance
• onError：错误回调 (error: RiveError) => void

数据绑定详见：

• 运行时 Data Binding

Legacy Runtime

Legacy <Rive /> 常见属性：

• 文件来源：resourceName / url / source
• 播放控制：autoplay、animationName、stateMachineName
• 布局：fit、alignment、style
• 回调：onPlay、onPause、onStop、onLoopEnd、onStateChanged、onError
• 事件：onRiveEventReceived

说明：Legacy 仍可用，但建议迁移到新版。