`ime.openSession()`

为已聚焦的应用绘图面创建输入法会话，并把当前文本和选择状态交给宿主。

Syntax

const session = await host.ime.openSession(canvasId, state);

Parameters

state 使用模块页的 ImeState 封闭结构，包含 UTF-16 文本、选择、可选合成范围、输入模式、多行标记和初始 revision。所有范围必须落在 Unicode 标量边界内。

Return value

Handle<ime-session, rw, app-context, focus>

Examples

const session = await host.ime.openSession('editor', {
  text: editor.text,
  selection: editor.selection,
  inputMode: 'text',
  multiline: true,
  revision: editor.revision,
});

Errors

特有错误：denied、not-focused、invalid-range、session-exists、limit-exceeded。

Requirements

能力：host:ime.openSession
有效且已聚焦的 canvas
信任档位：green

ime.openSession()