ime.closeSession()
结束输入法会话并使句柄失效。重复关闭是幂等操作。
Syntax
await host.ime.closeSession(session);
Examples
async function blurEditor() {
await host.ime.closeSession(session);
session = null;
}
关闭前是否提交当前合成文本由明确的编辑状态和宿主事件决定,不能靠销毁时机猜测。
Errors
特有错误:stale-handle、resource-denied。同一会话重复关闭不报错。
Parameters
session: Handle<ime-session, rw, app-context, focus>:要关闭的本应用会话。
Return value
无。关闭后句柄立即失效;若应用声明了 ime.ended,宿主发送一次 reason 为 closed 的事件。
Requirements
- 授权:
handle-derived,不进入 manifest capability 列表 - 用户激活:不需要
- 信任档位:green