ime.updateState()

在 guest 应用编辑操作后，把权威状态和单调 revision 同步给宿主。

Syntax

await host.ime.updateState(session, state);

Parameters

参数	类型	说明
session	ime-session handle	当前焦点会话
state	ImeState & { revision: u64 }	文本、选择、合成范围与版本

Return value

无。

Examples

host.events.on('ime.textUpdate', async ({ handle, update }) => {
  if (handle !== session) return;
  editor.apply(update);
  await host.ime.updateState(session, {
    ...editor.snapshot(),
    revision: editor.revision,
  });
});

Errors

特有错误：stale-handle、resource-denied、stale-state、invalid-range、limit-exceeded。revision 必须严格大于上次成功同步值；过期或相同 revision 不得覆盖状态。

Requirements

• 授权：handle-derived，需要活动 ime-session 的 rw 权限
• 用户激活：不需要
• 信任档位：green

See also

ime.textUpdate、ime.composition