当用户有跨语种交流或内容翻译的需求时，应用需要能自动检测文本的语种再进行翻译。
HMS Core机器学习服务的语种检测服务提供在线语种检测和离线语种检测，既支持检测单语种文本，也支持检测混合语种文本，涵盖南非荷兰语、阿拉伯语等百种语言。接入语种检测服务，App可以轻松实现翻译语种检测、网页语种检测，混合语种场景中语种检测等，帮助App提升用户体验。
语种检测流程
输入文本，机器学习服务语种对该文本自动进行语种进行检测，然后返回对应语种编码和相应的置信度，或者返回一个置信度最高的语种编码给开发者的应用。最终在开发app页面呈现出翻译出的文本。
![]()
效果演示
![]()
1.开发准备
在进行开发前需要配置HMS Core SDK的Maven仓地址
repositories {
maven {
url'https://cmc.centralrepo.rnd.huawei.com/artifactory/product_maven/' }
}
集成在线语种检测服务SDK，示例代码如下
dependencies{
implementation 'com.huawei.hms:ml-computer-language-detection:3.4.0.301'
}
2. 编辑工程集成
2.1设置应用的鉴权信息
可以通过api_key或者Access Token来设置应用鉴权信息。
通过setAccessToken方法设置Access Token，在应用启动时初始化设置一次即可，无需多次设置。
MLApplication.getInstance().setAccessToken("your access token");
通过setApiKey方法设置api_key，在应用启动时初始化设置一次即可，无需多次设置。
MLApplication.getInstance().setApiKey("your ApiKey");
2.2 创建语种检测器
// 方式一：使用默认的参数配置创建语种检测器。
MLRemoteLangDetector mlRemoteLangDetector = MLLangDetectorFactory.getInstance()
.getRemoteLangDetector();
// 方式二：使用自定义的参数配置创建语种检测器。
MLRemoteLangDetectorSetting setting = new MLRemoteLangDetectorSetting.Factory()
// 设置语种检测的最低置信度阈值。
.setTrustedThreshold(0.01f)
.create();
MLRemoteLangDetector mlRemoteLangDetector = MLLangDetectorFactory.getInstance()
.getRemoteLangDetector(setting);
2.3 进行语种检测
异步方法示例代码
// 方式一：返回多个语种检测结果，包括语种编码以及置信度，sourceText表示待检测的文本，长度需小于5000个字符。
Task<List<MLDetectedLang>> probabilityDetectTask = mlRemoteLangDetector.probabilityDetect(sourceText);
probabilityDetectTask.addOnSuccessListener(new OnSuccessListener<List<MLDetectedLang>>() {
@Override
public void onSuccess(List<MLDetectedLang> result) {
// 成功的处理逻辑。
}
}).addOnFailureListener(new OnFailureListener() {
@Override
public void onFailure(Exception e) {
// 失败的处理逻辑。
// Recognition failure.
try {
MLException mlException = (MLException)e;
// 获取错误码，开发者可以对错误码进行处理，根据错误码进行差异化的页面提示。
int errorCode = mlException.getErrCode();
// 获取报错信息，开发者可以结合错误码，快速定位问题。
String errorMessage = mlException.getMessage();
} catch (Exception error) {
// 转换错误处理。
}
}
});
// 方式二：返回置信度最高的语种编码，sourceText表示待检测的文本，长度需小于5000个字符。
Task<String> firstBestDetectTask = mlRemoteLangDetector.firstBestDetect(sourceText);
firstBestDetectTask.addOnSuccessListener(new OnSuccessListener<String>() {
@Override
public void onSuccess(String s) {
// 成功的处理逻辑。
}
}).addOnFailureListener(new OnFailureListener() {
@Override
public void onFailure(Exception e) {
// 失败的处理逻辑。
// Recognition failure.
try {
MLException mlException = (MLException)e;
// 获取错误码，开发者可以对错误码进行处理，根据错误码进行差异化的页面提示。
int errorCode = mlException.getErrCode();
// 获取报错信息，开发者可以结合错误码，快速定位问题。
String errorMessage = mlException.getMessage();
} catch (Exception error) {
// 转换错误处理。
}
}
});
同步方法示例代码
// 方式一：返回多个语种检测结果，包括语种编码以及置信度，sourceText表示待检测的文本，长度需小于5000个字符。
try {
List<MLDetectedLang> result= mlRemoteLangDetector.syncProbabilityDetect(sourceText);
} catch (MLException mlException) {
// 失败的处理逻辑。
// 获取错误码，开发者可以对错误码进行处理，根据错误码进行差异化的页面提示。
int errorCode = mlException.getErrCode();
// 获取报错信息，开发者可以结合错误码，快速定位问题。
String errorMessage = mlException.getMessage();
}
// 方式二：返回置信度最高的语种编码，sourceText表示待检测的文本，长度需小于5000个字符。
try {
String language = mlRemoteLangDetector.syncFirstBestDetect(sourceText);
} catch (MLException mlException) {
// 失败的处理逻辑。
// 获取错误码，开发者可以对错误码进行处理，根据错误码进行差异化的页面提示。
int errorCode = mlException.getErrCode();
// 获取报错信息，开发者可以结合错误码，快速定位问题。
String errorMessage = mlException.getMessage();
}
2.4 检测完成后，释放资源。
if (mlRemoteLangDetector != null) {
mlRemoteLangDetector.stop();
}
语种检测功能包含端侧和云侧，以上示例仅为云侧功能。
了解更多详情>>
访问华为开发者联盟官网
获取开发指导文档
华为移动服务开源仓库地址：GitHub、Gitee
关注我们，第一时间了解 HMS Core 最新技术资讯~
