# inputmethod_controller_capi.h

> phone 12+ | 2in1 13+ | tablet 12+ | tv 19+ | wearable 18+

## 概述

提供绑定、解绑输入法的方法，是应用与输入法服务交互的核心入口。

功能：通过OH_InputMethodController_Attach将应用绑定到输入法服务，建立双向交互通道；通过OH_InputMethodController_Detach将应用从输入法服务解除绑定，关闭交互通道并释放相关资源。

使用场景：适用于使用NDK开发自绘输入框的应用，需要在应用启动或输入框获得焦点时绑定输入法服务，在应用退出或输入框失去焦点时解绑输入法服务的场景。

使用后效果：OH_InputMethodController_Attach成功后，应用可通过返回的InputMethodProxy与输入法交互（如显示/隐藏键盘、通知光标更新等），同时输入法可通过TextEditorProxy的回调向应用发送文本插入、删除等通知。OH_InputMethodController_Detach后，交互通道关闭，inputMethodProxy不再有效。

**引用文件：** <inputmethod/inputmethod_controller_capi.h>

**库：** libohinputmethod.so

**系统能力：** SystemCapability.MiscServices.InputMethodFramework

**起始版本：** 12

**相关模块：** [InputMethod](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod)

## 汇总

### 函数

|名称|描述|
|:----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|:---------------------------------------------------------------------------------------------------------------------------------------------|
|[InputMethod_ErrorCode OH_InputMethodController_Attach(InputMethod_TextEditorProxy *textEditorProxy, InputMethod_AttachOptions *options, InputMethod_InputMethodProxy **inputMethodProxy)](#oh_inputmethodcontroller_attach)|将应用绑定到输入法服务。必须在创建TextEditorProxy和AttachOptions之后调用，绑定成功后返回InputMethodProxy用于后续交互。必须与OH_InputMethodController_Detach配对调用。|
|[InputMethod_ErrorCode OH_InputMethodController_AttachWithUIContext(ArkUI_ContextHandle context, InputMethod_TextEditorProxy *textEditorProxy, InputMethod_AttachOptions *options, InputMethod_InputMethodProxy **inputMethodProxy)](#oh_inputmethodcontroller_attachwithuicontext)|将应用绑定到输入法服务，同时携带UI上下文信息。适用于需要将输入法与特定UI页面关联的场景（如多窗口场景下指定绑定到哪个页面）。必须在创建TextEditorProxy和AttachOptions之后调用，必须与OH_InputMethodController_Detach配对调用。|
|[InputMethod_ErrorCode OH_InputMethodController_Detach(InputMethod_InputMethodProxy *inputMethodProxy)](#oh_inputmethodcontroller_detach)|将应用从输入法服务解除绑定。必须在OH_InputMethodController_Attach或AttachWithUIContext之后调用，解绑后inputMethodProxy不再有效，不可继续使用。|

## 函数说明

### OH_InputMethodController_Attach()

```c
InputMethod_ErrorCode OH_InputMethodController_Attach(InputMethod_TextEditorProxy *textEditorProxy, InputMethod_AttachOptions *options, InputMethod_InputMethodProxy **inputMethodProxy)
```

**描述**

将应用绑定到输入法服务，建立应用与输入法之间的双向交互通道。绑定成功后，应用可通过返回的InputMethodProxy主动向输入法发送请求和通知，同时输入法可通过TextEditorProxy中注册的回调函数向应用发送文本插入、删除等通知。

前置条件：

1. 必须先通过OH_TextEditorProxy_Create创建InputMethod_TextEditorProxy实例，并通过OH_TextEditorProxy_SetXXXFunc系列函数注册必要的回调（如InsertTextFunc、DeleteForwardFunc、GetTextConfigFunc等）。
2. 必须先通过OH_AttachOptions_Create或OH_AttachOptions_CreateWithRequestKeyboardReason创建InputMethod_AttachOptions实例。
3. TextEditorProxy中注册的回调函数必须已正确实现，否则输入法交互将不完整。

配对调用：

* 调用OH_InputMethodController_Attach后，必须在使用完毕后调用OH_InputMethodController_Detach解除绑定。
* 未调用OH_InputMethodController_Detach会导致输入法资源泄漏。
* 建议在应用退出或输入框不再需要输入法时及时调用OH_InputMethodController_Detach。

调用顺序：

1. OH_TextEditorProxy_Create → 创建TextEditorProxy
2. OH_TextEditorProxy_SetXXXFunc → 注册回调函数
3. OH_AttachOptions_Create → 创建AttachOptions
4. OH_InputMethodController_Attach → 绑定输入法（返回InputMethodProxy）
5. OH_InputMethodProxy_ShowKeyboard / NotifyCursorUpdate 等 → 使用输入法功能
6. OH_InputMethodController_Detach → 解绑输入法
7. OH_TextEditorProxy_Destroy / OH_AttachOptions_Destroy → 销毁创建的对象

生命周期管理：

* textEditorProxy：调用者自行管理生命周期。若OH_InputMethodController_Attach成功，在下次OH_InputMethodController_Attach或OH_InputMethodController_Detach完成之前不可释放textEditorProxy，否则会导致输入法回调时访问无效内存。
* options：调用者自行管理生命周期。OH_InputMethodController_Attach调用完成后，options可立即通过OH_AttachOptions_Destroy销毁，因为OH_InputMethodController_Attach过程已读取完options中的配置信息。
* inputMethodProxy：由OH_InputMethodController_Attach函数通过双指针输出参数分配内存，调用者在OH_InputMethodController_Detach之前需保持inputMethodProxy有效，OH_InputMethodController_Detach后该指针不可继续使用。

线程安全：非线程安全，建议在主线程调用。

**起始版本：** 12

**参数：**

|参数项|描述|
|:-----------------------------------------------------------------------------------------------------------------------------------------------------------------|:---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|[InputMethod_TextEditorProxy](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-inputmethod-texteditorproxy) *textEditorProxy|输入指针，表示指向InputMethod_TextEditorProxy实例的指针。含义/功能：作为应用接收输入法回调通知的通道载体，绑定后输入法将通过此对象中注册的回调函数与应用交互。使用场景：在绑定输入法前，应用需先创建TextEditorProxy并注册必要的回调函数。使用后效果：若OH_InputMethodController_Attach成功，输入法将通过此对象中的回调函数向应用发送通知；若失败，此对象不受影响可继续使用。 前置条件：必须通过OH_TextEditorProxy_Create创建，并通过SetXXXFunc系列函数注册回调。 NULL指针处理：不可为NULL，传入NULL将返回IME_ERR_NULL_POINTER。 生命周期管理：调用者自行管理。若Attach成功，在下次OH_InputMethodController_Attach或OH_InputMethodController_Detach完成之前不可释放textEditorProxy，否则输入法回调时将访问已释放的内存导致未定义行为。 内存分配责任：由调用者通过OH_TextEditorProxy_Create分配，通过OH_TextEditorProxy_Destroy释放。|
|[InputMethod_AttachOptions](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-inputmethod-attachoptions) *options|输入指针，表示指向InputMethod_AttachOptions实例的指针。含义/功能：指定绑定输入法时的行为配置，包括是否在绑定时显示键盘以及请求键盘的原因。使用场景：在绑定前创建并配置好AttachOptions，用于控制绑定时的键盘显示行为。使用后效果：OH_InputMethodController_Attach函数将读取options中的配置参数来决定绑定行为。 前置条件：必须通过OH_AttachOptions_Create或OH_AttachOptions_CreateWithRequestKeyboardReason创建。 NULL指针处理：不可为NULL，传入NULL将返回IME_ERR_NULL_POINTER。 生命周期管理：OH_InputMethodController_Attach完成后options可立即销毁，因为绑定过程已读取完配置信息。建议在OH_InputMethodController_Attach成功后调用OH_AttachOptions_Destroy释放内存。 内存分配责任：由调用者通过Create函数分配，通过OH_AttachOptions_Destroy释放。|
|[InputMethod_InputMethodProxy](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-inputmethod-inputmethodproxy) **inputMethodProxy|输出双指针，表示指向InputMethod_InputMethodProxy指针的指针。含义/功能：用于接收OH_InputMethodController_Attach成功后返回的InputMethodProxy实例，该实例是应用主动向输入法发送请求和通知的交互通道。使用场景：OH_InputMethodController_Attach成功后，调用者通过此指针获取InputMethodProxy，后续调用ShowKeyboard、HideKeyboard、NotifyCursorUpdate等函数时需传入此指针。使用后效果：若OH_InputMethodController_Attach成功，*inputMethodProxy将被赋值为有效的InputMethodProxy指针；若失败，*inputMethodProxy的值不确定，不应使用。 双指针说明：此参数为双指针（Pointer to Pointer），OH_InputMethodController_Attach函数内部将分配InputMethodProxy的内存并通过此双指针输出给调用者。调用者需提供有效的指针变量地址，不可为NULL。 NULL指针处理：inputMethodProxy本身不可为NULL，传入NULL将返回IME_ERR_NULL_POINTER。 内存管理：InputMethodProxy的内存由OH_InputMethodController_Attach函数内部分配，其生命周期由框架管理直到OH_InputMethodController_Detach完成。调用者不可自行释放此内存。OH_InputMethodController_Detach后inputMethodProxy指向的内存将被释放，该指针不可继续使用。 相关参数制约：此指针仅在OH_InputMethodController_Attach返回IME_ERR_OK时有效；OH_InputMethodController_Detach后此指针立即失效，不可继续使用，否则会导致未定义行为或崩溃。|

**返回：**

|类型|说明|
|:---------------------------------------------------------------------------------------------------------------------------------------------|:---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|[InputMethod_ErrorCode](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-types-capi-h#inputmethod_errorcode)|返回一个特定的错误码。 [IME_ERR_OK](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-types-capi-h#inputmethod_errorcode) - 表示成功。此时*inputMethodProxy有效，可用于后续交互。 [IME_ERR_PARAMCHECK](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-types-capi-h#inputmethod_errorcode) - 表示参数错误。检查textEditorProxy、options、inputMethodProxy是否为有效指针。 [IME_ERR_IMCLIENT](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-types-capi-h#inputmethod_errorcode) - 输入法客户端错误。可能是输入法服务未就绪或连接异常。 [IME_ERR_IMMS](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-types-capi-h#inputmethod_errorcode) - 输入法服务错误。可能是系统输入法管理服务异常。 [IME_ERR_NULL_POINTER](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-types-capi-h#inputmethod_errorcode) - 非预期的空指针。textEditorProxy、options或inputMethodProxy为NULL时返回。 错误处理建议：若返回非IME_ERR_OK，应检查参数有效性后重试；若返回IME_ERR_IMCLIENT或IME_ERR_IMMS，说明服务异常，建议稍后重试。具体错误码可以参考[InputMethod_ErrorCode](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-types-capi-h#inputmethod_errorcode)。|

### OH_InputMethodController_AttachWithUIContext()

```c
InputMethod_ErrorCode OH_InputMethodController_AttachWithUIContext(ArkUI_ContextHandle context, InputMethod_TextEditorProxy *textEditorProxy, InputMethod_AttachOptions *options, InputMethod_InputMethodProxy **inputMethodProxy)
```

**描述**

将应用绑定到输入法服务，同时携带UI上下文信息。与OH_InputMethodController_Attach的区别在于，此函数额外接受一个ArkUI_ContextHandle参数，用于在多窗口或多页面场景下指定绑定到具体的UI上下文，使输入法服务能精确关联到当前活跃的页面。

前置条件：

1. 必须先获取有效的ArkUI_ContextHandle（通过ArkUI模块创建UI上下文获取）。
2. 必须先通过OH_TextEditorProxy_Create创建InputMethod_TextEditorProxy实例，并通过OH_TextEditorProxy_SetXXXFunc系列函数注册必要的回调。
3. 必须先通过OH_AttachOptions_Create或OH_AttachOptions_CreateWithRequestKeyboardReason创建InputMethod_AttachOptions实例。

配对调用：

* 调用OH_InputMethodController_AttachWithUIContext后，必须在使用完毕后调用OH_InputMethodController_Detach解除绑定。
* 未调用OH_InputMethodController_Detach会导致输入法资源泄漏。

调用顺序：

1. 获取ArkUI_ContextHandle
2. OH_TextEditorProxy_Create → 创建TextEditorProxy
3. OH_TextEditorProxy_SetXXXFunc → 注册回调函数
4. OH_AttachOptions_Create → 创建AttachOptions
5. OH_InputMethodController_AttachWithUIContext → 绑定输入法（携带UI上下文）
6. OH_InputMethodProxy_ShowKeyboard / NotifyCursorUpdate 等 → 使用输入法功能
7. OH_InputMethodController_Detach → 解绑输入法
8. 销毁创建的对象

生命周期管理：

* context：由ArkUI模块管理，需在绑定期间保持有效。
* textEditorProxy：调用者自行管理。若OH_InputMethodController_AttachWithUIContext成功，在下次OH_InputMethodController_AttachWithUIContext或OH_InputMethodController_Detach完成之前不可释放。
* options：OH_InputMethodController_AttachWithUIContext完成后可立即销毁。
* inputMethodProxy：由AttachWithUIContext函数内部分配，OH_InputMethodController_Detach后释放。

使用场景：适用于多窗口或多页面应用场景，需要将输入法绑定到特定UI页面的场景。当应用有多个UI上下文（如多窗口），使用此函数可确保输入法与正确的页面关联，避免输入法事件发送到错误的窗口。

线程安全：非线程安全，建议在主线程调用。

**起始版本：** 23

**参数：**

|参数项|描述|
|:-----------------------------------------------------------------------------------------------------------------------------------------------------------------|:------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|[ArkUI_ContextHandle](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-arkui-nativemodule-arkui-context8h) context|输入指针，表示指向ArkUI_Context实例的指针。含义/功能：指定输入法绑定到哪个UI上下文（页面/窗口），使输入法服务能精确关联到当前活跃的页面。使用场景：在多窗口或多页面应用中，需要将输入法绑定到特定UI上下文时使用。使用后效果：输入法事件将发送到与此上下文关联的页面。 前置条件：必须通过ArkUI模块获取有效的ArkUI_ContextHandle。 NULL指针处理：不可为NULL，传入NULL将返回IME_ERR_NULL_POINTER。 生命周期管理：需在绑定期间保持ArkUI_Context有效，OH_InputMethodController_Detach前不可销毁对应的UI上下文。|
|[InputMethod_TextEditorProxy](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-inputmethod-texteditorproxy) *textEditorProxy|输入指针，表示指向InputMethod_TextEditorProxy实例的指针。含义/功能：与OH_InputMethodController_Attach中的textEditorProxy参数相同，作为应用接收输入法回调通知的通道载体。使用场景、前置条件、NULL指针处理、生命周期管理均与OH_InputMethodController_Attach中textEditorProxy参数一致。|
|[InputMethod_AttachOptions](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-inputmethod-attachoptions) *options|输入指针，表示指向InputMethod_AttachOptions实例的指针。含义/功能：与OH_InputMethodController_Attach中的options参数相同，用于指定绑定时的行为配置。使用场景、前置条件、NULL指针处理、生命周期管理均与OH_InputMethodController_Attach中options参数一致。|
|[InputMethod_InputMethodProxy](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-inputmethod-inputmethodproxy) **inputMethodProxy|输出双指针，表示指向InputMethod_InputMethodProxy指针的指针。含义/功能、使用场景、双指针说明、NULL指针处理、内存管理、相关参数制约均与OH_InputMethodController_Attach中的inputMethodProxy参数一致。|

**返回：**

|类型|说明|
|:---------------------------------------------------------------------------------------------------------------------------------------------|:-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|[InputMethod_ErrorCode](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-types-capi-h#inputmethod_errorcode)|返回一个特定的错误码。 [IME_ERR_OK](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-types-capi-h#inputmethod_errorcode) - 表示成功。此时*inputMethodProxy有效，可用于后续交互。 [IME_ERR_PARAMCHECK](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-types-capi-h#inputmethod_errorcode) - 表示参数错误。检查context、textEditorProxy、options、inputMethodProxy是否为有效指针。 [IME_ERR_IMCLIENT](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-types-capi-h#inputmethod_errorcode) - 输入法客户端错误。 [IME_ERR_IMMS](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-types-capi-h#inputmethod_errorcode) - 输入法服务错误。 [IME_ERR_NULL_POINTER](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-types-capi-h#inputmethod_errorcode) - 非预期的空指针。context、textEditorProxy、options或inputMethodProxy为NULL时返回。 错误处理建议：若返回非IME_ERR_OK，应检查参数有效性后重试；若返回IME_ERR_IMCLIENT或IME_ERR_IMMS，说明服务异常，建议稍后重试。具体错误码可以参考[InputMethod_ErrorCode](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-types-capi-h#inputmethod_errorcode)。|

### OH_InputMethodController_Detach()

```c
InputMethod_ErrorCode OH_InputMethodController_Detach(InputMethod_InputMethodProxy *inputMethodProxy)
```

**描述**

将应用从输入法服务解除绑定，关闭交互通道。OH_InputMethodController_Detach后，inputMethodProxy不再有效，不可继续使用任何通过inputMethodProxy调用的函数（如ShowKeyboard、HideKeyboard、NotifyCursorUpdate等），否则会导致未定义行为或崩溃。

前置条件：

* 必须先调用OH_InputMethodController_Attach或OH_InputMethodController_AttachWithUIContext成功绑定输入法，并获得有效的inputMethodProxy。

调用顺序：

* 必须先调用OH_InputMethodController_Attach或OH_InputMethodController_AttachWithUIContext绑定输入法。
* 调用OH_InputMethodController_Detach完成输入法使用后，不能再使用inputMethodProxy。
* OH_InputMethodController_Detach完成后，可安全销毁TextEditorProxy（通过OH_TextEditorProxy_Destroy）。

错误处理：

* 如果inputMethodProxy无效或未绑定，调用OH_InputMethodController_Detach会返回IME_ERR_NULL_POINTER或IME_ERR_IMCLIENT。
* 重复调用OH_InputMethodController_Detach使用同一个inputMethodProxy可能导致未定义行为，应避免。
* OH_InputMethodController_Detach失败后不应继续使用inputMethodProxy。

生命周期管理：

* OH_InputMethodController_Detach后，inputMethodProxy指向的内存由框架释放，调用者不可再使用此指针。
* OH_InputMethodController_Detach后，应用可安全销毁TextEditorProxy，因为输入法不再会通过回调访问TextEditorProxy。
* 建议OH_InputMethodController_Detach成功后立即调用OH_TextEditorProxy_Destroy和OH_AttachOptions_Destroy释放所有创建的对象。

线程安全：非线程安全，建议在主线程调用。

**起始版本：** 12

**参数：**

|参数项|描述|
|:----------------------------------------------------------------------------------------------------------------------------------------------------------------|:--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|[InputMethod_InputMethodProxy](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-inputmethod-inputmethodproxy) *inputMethodProxy|输入指针，表示指向InputMethod_InputMethodProxy实例的指针。含义/功能：指定要解除绑定的输入法代理实例，OH_InputMethodController_Detach将关闭此代理对应的交互通道并释放相关资源。使用场景：在应用不再需要输入法交互时调用，如应用退出、输入框失去焦点等。使用后效果：OH_InputMethodController_Detach成功后，inputMethodProxy立即失效，不可继续使用；输入法不再向应用发送回调通知。 前置条件：此指针必须由OH_InputMethodController_Attach或OH_InputMethodController_AttachWithUIContext成功返回。 NULL指针处理：不可为NULL，传入NULL将返回IME_ERR_NULL_POINTER。 生命周期管理：此指针由OH_InputMethodController_Attach/AttachWithUIContext函数分配，OH_InputMethodController_Detach成功后由框架释放，调用者不可自行释放，也不可在OH_InputMethodController_Detach后继续使用。 使用注意：Detach后此指针立即失效，将此指针传入任何InputMethodProxy相关函数会导致未定义行为。同一inputMethodProxy不可重复调用OH_InputMethodController_Detach。|

**返回：**

|类型|说明|
|:---------------------------------------------------------------------------------------------------------------------------------------------|:---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|[InputMethod_ErrorCode](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-types-capi-h#inputmethod_errorcode)|返回一个特定的错误码。 [IME_ERR_OK](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-types-capi-h#inputmethod_errorcode) - 表示成功。解绑完成，inputMethodProxy不再有效。 [IME_ERR_IMCLIENT](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-types-capi-h#inputmethod_errorcode) - 表示输入法客户端错误。可能是客户端连接异常或已断开。 [IME_ERR_IMMS](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-types-capi-h#inputmethod_errorcode) - 表示输入法服务错误。可能是服务端异常。 [IME_ERR_NULL_POINTER](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-types-capi-h#inputmethod_errorcode) - 非预期的空指针。inputMethodProxy为NULL时返回。 错误处理建议：若返回IME_ERR_OK，解绑成功，后续可安全销毁所有创建的对象；若返回IME_ERR_IMCLIENT，说明客户端状态异常，建议记录日志并销毁相关对象；若返回IME_ERR_NULL_POINTER，说明传入的指针无效，应检查是否已OH_InputMethodController_Detach或指针已失效。具体错误码可以参考[InputMethod_ErrorCode](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-types-capi-h#inputmethod_errorcode)。|