开发者社区 问答 正文

义听悟的实时记录接口流程图中有个暂停识别标识操作,阿里云OpenAPI这个操作该怎么请求?

https://help.aliyun.com/zh/tingwu/interface-and-implementation?spm=a2c4g.11186623.0.0.4f37746doEUu68 通义听悟的实时记录接口流程图中有个暂停识别标识操作,阿里云OpenAPI这个操作该怎么请求?

展开
收起
三分钟热度的鱼 2024-05-03 17:48:00 75 分享 版权
阿里云 AI 助理回答

在通义听悟的实时记录接口中,暂停识别的操作是通过调用阿里云OpenAPI实现的。以下是具体的操作步骤和请求方式:


1. 暂停识别操作的背景

在实时语音推流过程中,用户可能需要临时暂停语音识别(例如会议中场休息或静音时段)。通义听悟提供了暂停识别的功能,允许开发者通过特定的API请求来控制识别流程。


2. 请求方式

暂停识别的操作可以通过调用CreateTask接口并设置相关参数来实现。以下是具体的请求步骤和参数说明:

请求方法

  • HTTP方法PUT
  • 请求路径/openapi/tingwu/v2/tasks

请求参数

在请求体中,您需要指定以下关键字段: - TaskId:任务的唯一标识符,用于定位需要暂停的任务。 - Operation:操作类型,设置为pause以暂停识别。 - Type:任务类型,设置为realtime以表示实时记录任务。

示例请求体如下:

{
  "TaskId": "3190978427bb43z09c01dfff********",
  "Operation": "pause",
  "Type": "realtime"
}

请求头

  • Content-Typeapplication/json
  • Authorization:使用AccessKey和SecretKey生成的签名信息,确保请求的安全性。

3. 示例代码

以下是基于Java语言的示例代码,展示如何发送暂停识别的请求:

import com.alibaba.fastjson.JSONObject;
import com.aliyuncs.DefaultAcsClient;
import com.aliyuncs.IAcsClient;
import com.aliyuncs.exceptions.ClientException;
import com.aliyuncs.profile.DefaultProfile;
import com.aliyuncs.http.MethodType;
import com.aliyuncs.http.ProtocolType;

public class PauseRealtimeTask {
    public static void main(String[] args) throws ClientException {
        // 初始化客户端
        DefaultProfile profile = DefaultProfile.getProfile(
            "cn-beijing", 
            System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID"), 
            System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET")
        );
        IAcsClient client = new DefaultAcsClient(profile);

        // 构造请求
        CommonRequest request = new CommonRequest();
        request.setSysMethod(MethodType.PUT);
        request.setSysProtocol(ProtocolType.HTTPS);
        request.setSysDomain("tingwu.cn-beijing.aliyuncs.com");
        request.setSysVersion("2023-09-30");
        request.setSysAction("/openapi/tingwu/v2/tasks");

        // 设置查询参数
        request.putQueryParameter("type", "realtime");

        // 设置请求体
        JSONObject requestBody = new JSONObject();
        requestBody.put("TaskId", "3190978427bb43z09c01dfff********");
        requestBody.put("Operation", "pause");
        requestBody.put("Type", "realtime");

        request.setHttpContent(requestBody.toJSONString().getBytes(), "utf-8", "application/json");

        // 发送请求并获取响应
        CommonResponse response = client.getCommonResponse(request);
        System.out.println(response.getData());
    }
}

4. 响应结果

成功暂停识别后,API将返回以下字段: - Code:状态码,0表示成功。 - Message:操作结果描述。 - RequestId:请求的唯一标识符,用于排查问题。

示例响应:

{
  "Code": "0",
  "Message": "success",
  "RequestId": "6582c654-cc37-4f2d-b80d-e5e7********"
}

5. 注意事项

  • 权限管理:确保您的AccessKey和SecretKey具有调用CreateTask接口的权限。
  • 任务状态检查:在暂停识别前,请确认任务处于running状态,否则可能导致操作失败。
  • 恢复识别:如果需要恢复识别,可以调用相同的接口并将Operation设置为resume

通过上述步骤,您可以成功实现通义听悟实时记录中的暂停识别功能。如果有进一步的问题,请参考官方文档或联系技术支持团队。

有帮助
无帮助
AI 助理回答生成答案可能存在不准确,仅供参考
0 条回答
写回答
取消 提交回答