更新时间:2024-07-30 GMT+08:00

设置语言

SetLanguage

接口描述

该接口设置界面显示语言。默认是中文。

注意事项

该接口为异步接口,返回值只代表接口是否调用成功,实际业务处理结果在对应的回调函数中返回。

方法定义

1
HWM_SDK_AGENT_API hwmsdk::HwmErrCode SetLanguage(HwmLanguage language);

回调函数

1
virtual void OnSetLanguageResult(hwmsdk::HwmErrCode ret, const char* reason) {};

参数描述

表1 参数说明

参数

是否必须

类型

描述

language

HwmLanguage

界面语言枚举。

表2 枚举HwmLanguage说明

枚举值

描述

HWM_LANGUAGE_ZH_CN

中文。

HWM_LANGUAGE_EN_GB

英文。

HWM_LANGUAGE_CUSTOMIZED

自定义语言

返回值

表3 返回值

类型

描述

HwmErrCode

成功返回0,其他值表示失败。失败返回值见错误码参考

示例代码

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
/**
* 修改语言
*/
void demoSettingDlg::OnBnClickedButtonSetLanCode()
{
    // 设置语言为中文
    hwmsdkagent::HwmLanguage languageCode = hwmsdkagent::HWM_LANGUAGE_ZH_CN;
 
    int ret = hwmsdkagent::SetLanguage((hwmsdkagent::HwmLanguage)languageCode);
    if (hwmsdk::HWM_COMMON_SUCCESS != ret)
    {
        AfxMessageBox(_T("SetLanguage error"));
    }
}

SetLanguageWithCode

接口描述

该接口用于自定义设置SDK国际化语言。默认是中文。

注意事项

  1. 实现自定义语言,要求在 \HwmSdk\sdkResources\language\ 目录下创建对应的国际化文件。如新增阿拉伯语则可以创建 \ar\temp.js,通过该接口设置的语言应与系统当前语言保持一致
  2. 该接口为异步接口,返回值只代表接口是否调用成功,实际业务处理结果在对应的回调函数中返回。

方法定义

1
HWM_SDK_AGENT_API hwmsdk::HwmErrCode SetLanguageWithCode(HwmLanguage language, const char* languageCode);

回调函数

1
virtual void OnSetLanguageResult(hwmsdk::HwmErrCode ret, const char* reason) {};

参数描述

表4 参数说明

参数

是否必须

类型

描述

language

HwmLanguage

界面语言枚举。

languageCode

char[]

自定义时对应的语言代码,若是中文/英文,该参数可以传空字符串

返回值

表5 返回值

类型

描述

HwmErrCode

成功返回0,其他值表示失败。失败返回值见错误码参考

示例代码

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
/**
* 修改语言
*/
void demoSettingDlg::OnBnClickedButtonSetLanCode()
{
    // 设置自定义语言为阿拉伯语
    hwmsdkagent::HwmLanguage languageCode = hwmsdkagent::HWM_LANGUAGE_CUSTOMIZED;
    CString code = "ar";
    int ret = hwmsdkagent::SetLanguageWithCode((hwmsdkagent::HwmLanguage)languageCode, CTools::UNICODE2UTF(code).c_str());
    if (hwmsdk::HWM_COMMON_SUCCESS != ret)
    {
        AfxMessageBox(_T("SetLanguageWithCode error"));
    }
}