腾讯云对象存储的《提交语音识别任务》描述得不够详细

副标题：对象存储《提交语音识别任务》易用性优化

前言

我需要实现小程序创建COS语音识别任务的功能，参考了官方教程提交语音识别任务，文档是被归类到数据万象下的，描述比较简单，又看到了比较痛苦的签名，而且没有一个完整的demo。

官方教程链接：https://cloud.tencent.com/document/product/460/46228

控制台用起来

这里截图表示对应控制台的哪个功能，方便快速了解。就是这个功能：

控制台创建任务

对应的接口

curl 'https://image.cloud.tencent.com/voice_job/create?_language=zh&_format=json&_uin=100022907677&_ownerUin=100022907677&mc_gtk=84298440&_=1640078071827' \
  -H 'Connection: keep-alive' \
  -H 'sec-ch-ua: " Not A;Brand";v="99", "Chromium";v="96", "Google Chrome";v="96"' \
  -H 'Accept: application/json, text/javascript, */*; q=0.01' \
  -H 'Content-Type: application/x-www-form-urlencoded; charset=UTF-8' \
  -H 'sec-ch-ua-mobile: ?0' \
  -H 'User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/96.0.4664.93 Safari/537.36' \
  -H 'sec-ch-ua-platform: "macOS"' \
  -H 'Origin: https://console.cloud.tencent.com' \
  -H 'Sec-Fetch-Site: same-site' \
  -H 'Sec-Fetch-Mode: cors' \
  -H 'Sec-Fetch-Dest: empty' \

问题

这个COS语音识别功用算是跨界，一边在COS，一边是数据万象。代码实现创建任务的话有以下问题，比如COS的SDK比较丰富，但是不包含创建语音识别任务这个功能；而数据万象的文档又只是简单描述，处于两不管的状态，让人觉得很无奈。

COS的SDK

地址：https://github.com/tencentyun/cos-wx-sdk-v5

可以很简单的实现上传文件到COS中，所谓简单是指SDK和Demo比较丰富，不用户作很复杂的签名工作就可以跑起来。如下：

// 存储桶名称，由bucketname-appid 组成，appid必须填入，可以在COS控制台查看存储桶名称。 https://console.cloud.tencent.com/cos5/bucket
var Bucket = 'test-1250000000';
// 存储桶Region可以在COS控制台指定存储桶的概览页查看 https://console.cloud.tencent.com/cos5/bucket/
// 关于地域的详情见 https://cloud.tencent.com/document/product/436/6224
var Region = 'ap-guangzhou';

// 初始化实例
var cos = new COS({
    getAuthorization: function (options, callback) {
        // 异步获取签名
        wx.request({
            url: 'https://example.com/sts.php', // 步骤二提供的签名接口
            data: {
                Method: options.Method,
                Key: options.Key
            },
            dataType: 'text',
            success: function (result) {
                var data = result.data;
                callback({
                    TmpSecretId: data.credentials && data.credentials.tmpSecretId,
                    TmpSecretKey: data.credentials && data.credentials.tmpSecretKey,
                    XCosSecurityToken: data.credentials && data.credentials.sessionToken,
                    ExpiredTime: data.expiredTime,
                });
            }
        });
    }
});

// 选择文件
wx.chooseImage({
    count: 1, // 默认9
    sizeType: ['original'], // 可以指定是原图还是压缩图，默认用原图
    sourceType: ['album', 'camera'], // 可以指定来源是相册还是相机，默认二者都有
    success: function (res) {
        var filePath = res.tempFiles[0].path;
        var filename = filePath.substr(filePath.lastIndexOf('/') + 1);
        cos.postObject({
            Bucket: Bucket,
            Region: Region,
            Key: filename,
            FilePath: filePath,
            onProgress: function (info) {
                console.log(JSON.stringify(info));
            }
        }, function (err, data) {
            console.log(err || data);
        });
    }
});

回到数据万象

说明

使用COS的SDK让你摆脱了签名计算，当你准备使用创建语音识别任务功能时，你不得不继续回到原始人状态，还得研究如何计算签名，这种心情让人难以理解。更关键的是没有一个demo代码。

结论

在COS的SDK上加上创建语音识别任务的功能，或者把万象数据下的创建语音识别任务的demo搞得全面一点，让快速上手。

腾讯云的反馈

给了我一个基于COS SDK的万象调用接口的代码片段，经过测试比较好用。要远比万象文档上讲的简洁呢。

1. Demo

// config里的信息 自己替换下 QueueId在CI控制台可查
function CreateSpeechJobs() {
    var config = {
        Bucket: '',
        Region: '',
        InputKey: 'test.mp3',
        OutputKey: 'speech.txt',
        QueueId: 'p72918c3e41d54ebf9d5bf4ce4c9fd711',
    };
    var host = config.Bucket + '.ci.' + config.Region + '.myqcloud.com';
    var url = 'https://' + host + '/asr_jobs';
    cos.request({
        Bucket: config.Bucket,
        Region: config.Region,
        Method: 'POST',
        Key: 'asr_jobs',
        Url: url,
        Body: {
            Tag: 'SpeechRecognition',
            Input: {
                Object: config.InputKey,
            },
            Operation: {
                SpeechRecognition: {
                    EngineModelType: '16k_zh',
                    ChannelNum: '1',
                    ResTextFormat: '1',
                },
                Output: {
                    Bucket: config.Bucket,
                    Region: config.Region,
                    Object: config.OutputKey,
                },
            },
            QueueId: config.QueueId,
        },
    },
    function(err, data) {
        console.log(err || data);
    });
}

2. 关于sts权限配置

resource是这样的：'qcs::ci:' + config.region + ':uid/' + AppId + ':bucket/' + LongBucketName + '/' + config.allowPrefix allowActions可以设置成['name/ci:CreateAsrJobs']，这个就是最小粒度的授权

配置了这个才会不报401错误。

此问题暂告一段落。