410 VideoCallGrid 视频通话宫格

用途

按宫格显示调用方提供的视频帧，标记正在发言和静音的参与者。

最小示例

people := []messaging.CallParticipant{
	{ID: "1", Name: "Sakiko", Speaking: true}, // Frame: the latest decoded frame
	{ID: "2", Name: "Uika", Muted: true},
}
view := func(c *ui.Context) {
	core.Use(c, core.Settings{})
	messaging.VideoCallGrid(c, people, messaging.VideoCallGridOptions{})
}
ui.Render(view, 400, 300, 1)

参数

people []CallParticipant 的 ID 唯一、Name 必填；Frame ui.ImageSource 提供视频帧，Image 提供头像。Muted、CameraOff、Speaking 控制状态。Columns 默认 0，自动选择列数，必须 ≥ 0。

状态

状态由调用方数据控制；浅深主题、密度与文字缩放随窗口设置变化。适用插槽操作沿用控件焦点和禁用状态。

事件

纯展示，帧和参与者状态由调用方更新。

键盘操作

Tab 进入宫格；方向键移动参与者焦点并读取状态。

限制

视频解码、采集与帧更新由调用方处理，更新后调用 c.Invalidate()。