语音人工审核
本文介绍如何使用Java SDK语音人工审核接口。
功能描述
如果您认为语音检测结果(机审)与预期不符,可以使用语音人工审核。关于参数的详细信息,请参见语音人工审核API文档。
您需要使用内容安全的API接入地址,调用本SDK接口。关于API接入地址的信息,请参见接入地址(Endpoint)。
前提条件
安装Java依赖。关于安装Java依赖的具体操作,请参见安装Java依赖。
说明请一定按照安装Java依赖页面中的版本安装,否则会导致调用失败。
如果使用本地文件或者二进制文件检测,请下载并在项目工程中引入Extension.Uploader工具类。
提交语音人工审核任务
import com.alibaba.fastjson.JSON;
import com.alibaba.fastjson.JSONArray;
import com.alibaba.fastjson.JSONObject;
import com.aliyuncs.DefaultAcsClient;
import com.aliyuncs.IAcsClient;
import com.aliyuncs.exceptions.ClientException;
import com.aliyuncs.exceptions.ServerException;
import com.aliyuncs.green.model.v20180509.VoiceAsyncManualScanRequest;
import com.aliyuncs.http.FormatType;
import com.aliyuncs.http.HttpResponse;
import com.aliyuncs.http.MethodType;
import com.aliyuncs.http.ProtocolType;
import com.aliyuncs.profile.DefaultProfile;
import com.aliyuncs.profile.IClientProfile;
import java.util.Arrays;
public class VoiceAsyncManualScanSample {
public static void main(String[] args) throws Exception {
/**
* 阿里云账号AccessKey拥有所有API的访问权限,建议您使用RAM用户进行API访问或日常运维。
* 常见获取环境变量方式:
* 方式一:
* 获取RAM用户AccessKey ID:System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID");
* 获取RAM用户AccessKey Secret:System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET");
* 方式二:
* 获取RAM用户AccessKey ID:System.getProperty("ALIBABA_CLOUD_ACCESS_KEY_ID");
* 获取RAM用户AccessKey Secret:System.getProperty("ALIBABA_CLOUD_ACCESS_KEY_SECRET");
*/
DefaultProfile profile = DefaultProfile.getProfile(
"cn-shanghai",
"建议从环境变量中获取RAM用户AccessKey ID",
"建议从环境变量中获取RAM用户AccessKey Secret");
DefaultProfile.addEndpoint("cn-shanghai", "Green", "green.cn-shanghai.aliyuncs.com");
// 注意:此处实例化的client尽可能重复使用,提升检测性能。避免重复建立连接。
IAcsClient client = new DefaultAcsClient(profile);
VoiceAsyncManualScanRequest voiceAsyncManualScanRequest = new VoiceAsyncManualScanRequest();
// 指定API返回格式。
voiceAsyncManualScanRequest.setAcceptFormat(FormatType.JSON);
// 指定请求方法。
voiceAsyncManualScanRequest.setMethod(MethodType.POST);
voiceAsyncManualScanRequest.setEncoding("utf-8");
// 支持HTTP和HTTPS。
voiceAsyncManualScanRequest.setProtocol(ProtocolType.HTTP);
JSONObject task = new JSONObject();
task.put("dataId", "检测数据ID");
// 设置链接。
task.put("url", "待检测音频链接");
JSONObject httpBody = new JSONObject();
httpBody.put("tasks", Arrays.asList(task));
// callback、seed用于回调通知,可选参数。
httpBody.put("callback", "回调地址");
httpBody.put("seed", "随机字符串");
voiceAsyncManualScanRequest.setHttpContent(org.apache.commons.codec.binary.StringUtils.getBytesUtf8(httpBody.toJSONString()),
"UTF-8", FormatType.JSON);
/**
* 请设置超时时间。服务端全链路处理超时时间为10秒,请做相应设置。
* 如果您设置的ReadTimeout小于服务端处理的时间,程序中会获得一个ReadTimeout异常。
*/
voiceAsyncManualScanRequest.setConnectTimeout(3000);
voiceAsyncManualScanRequest.setReadTimeout(10000);
try {
HttpResponse httpResponse = client.doAction(voiceAsyncManualScanRequest);
// 服务端接收到请求,完成处理后返回的结果。
if (httpResponse != null && httpResponse.isSuccess()) {
JSONObject scrResponse = JSON.parseObject(org.apache.commons.codec.binary.StringUtils.newStringUtf8(httpResponse.getHttpContent()));
System.out.println(JSON.toJSONString(scrResponse, true));
int requestCode = scrResponse.getIntValue("code");
// 每一个任务的检测结果。
JSONArray taskResults = scrResponse.getJSONArray("data");
if (200 == requestCode) {
for (Object taskResult : taskResults) {
// 单个任务的处理结果。
int taskCode = ((JSONObject) taskResult).getIntValue("code");
if (200 == taskCode) {
// 保存taskId用于轮询结果。
System.out.println(((JSONObject)taskResult).getString("taskId"));
} else {
// 单个任务处理失败,原因视具体的情况详细分析。
System.out.println("task process fail. task response:" + JSON.toJSONString(taskResult));
}
}
} else {
/**
* 表明请求整体处理失败,原因视具体的情况详细分析。
*/
System.out.println("the whole scan request failed. response:" + JSON.toJSONString(scrResponse));
}
}
} catch (ServerException e) {
e.printStackTrace();
} catch (ClientException e) {
e.printStackTrace();
}
}
}
查询语音人工审核任务结果
import com.alibaba.fastjson.JSON;
import com.alibaba.fastjson.JSONArray;
import com.alibaba.fastjson.JSONObject;
import com.aliyuncs.DefaultAcsClient;
import com.aliyuncs.IAcsClient;
import com.aliyuncs.exceptions.ClientException;
import com.aliyuncs.exceptions.ServerException;
import com.aliyuncs.green.model.v20180509.ImageAsyncManualScanResultsRequest;
import com.aliyuncs.http.FormatType;
import com.aliyuncs.http.HttpResponse;
import com.aliyuncs.http.MethodType;
import com.aliyuncs.http.ProtocolType;
import com.aliyuncs.profile.DefaultProfile;
import com.aliyuncs.profile.IClientProfile;
import java.util.ArrayList;
import java.util.List;
public class VoiceAsyncManualScanResults {
public static void main(String[] args) throws Exception {
/**
* 阿里云账号AccessKey拥有所有API的访问权限,建议您使用RAM用户进行API访问或日常运维。
* 常见获取环境变量方式:
* 方式一:
* 获取RAM用户AccessKey ID:System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID");
* 获取RAM用户AccessKey Secret:System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET");
* 方式二:
* 获取RAM用户AccessKey ID:System.getProperty("ALIBABA_CLOUD_ACCESS_KEY_ID");
* 获取RAM用户AccessKey Secret:System.getProperty("ALIBABA_CLOUD_ACCESS_KEY_SECRET");
*/
DefaultProfile profile = DefaultProfile.getProfile(
"cn-shanghai",
"建议从环境变量中获取RAM用户AccessKey ID",
"建议从环境变量中获取RAM用户AccessKey Secret");
DefaultProfile.addEndpoint("cn-shanghai", "Green", "green.cn-shanghai.aliyuncs.com");
// 注意:此处实例化的client尽可能重复使用,提升检测性能。避免重复建立连接。
IAcsClient client = new DefaultAcsClient(profile);
ImageAsyncManualScanResultsRequest imageAsyncManualScanResultsRequest =
new ImageAsyncManualScanResultsRequest();
// 指定API返回格式。
imageAsyncManualScanResultsRequest.setAcceptFormat(FormatType.JSON);
// 指定请求方法。
imageAsyncManualScanResultsRequest.setMethod(MethodType.POST);
imageAsyncManualScanResultsRequest.setEncoding("utf-8");
// 支持HTTP和HTTPS。
imageAsyncManualScanResultsRequest.setProtocol(ProtocolType.HTTP);
List<String> taskIds = new ArrayList<String>();
// 这里添加要查询的taskId。提交任务的时候需要自行保存taskId。
taskIds.add("语音人工审核任务ID");
imageAsyncManualScanResultsRequest.setHttpContent(JSON.toJSONString(taskIds).getBytes("UTF-8"), "UTF-8", FormatType.JSON);
/**
* 请务必设置超时时间。
*/
imageAsyncManualScanResultsRequest.setConnectTimeout(3000);
imageAsyncManualScanResultsRequest.setReadTimeout(6000);
try {
HttpResponse httpResponse = client.doAction(imageAsyncManualScanResultsRequest);
if (httpResponse.isSuccess()) {
JSONObject scrResponse = JSON.parseObject(new String(httpResponse.getHttpContent(), "UTF-8"));
System.out.println(JSON.toJSONString(scrResponse, true));
if (200 == scrResponse.getInteger("code")) {
JSONArray taskResults = scrResponse.getJSONArray("data");
for (Object taskResult : taskResults) {
if (200 == ((JSONObject) taskResult).getInteger("code")) {
String url = ((JSONObject) taskResult).getString("url");
String taskId = ((JSONObject) taskResult).getString("taskId");
String suggestion = ((JSONObject) taskResult).getString("suggestion");
// 根据不同的suggestion结果做业务上的不同处理。例如,将违规数据删除等。
} else {
System.out.println("task process fail:" + ((JSONObject) taskResult).getInteger("code"));
}
}
} else {
System.out.println("detect not success. code:" + scrResponse.getInteger("code"));
}
} else {
System.out.println("response not success. status:" + httpResponse.getStatus());
}
} catch (ServerException e) {
e.printStackTrace();
} catch (ClientException e) {
e.printStackTrace();
}
}
}