腾讯Ai开放服务接入

1.接口调用通用形式

相关网址：https://ai.qq.com/doc/auth.shtml

如腾讯Ai给出的示例，其中app_id, time_stamp, nonce_str, sign为发起对腾讯Ai各种Api都需要加入到post请求的数据。而key1,key2则根据不同Api会有不同。如下面的OCR通用文字识别Api

图中唯一不同于示例的是把key1,key2换成了image,即待识别图片的base64编码数据。
实际上也是如此，对待不同的Api请求，只需要修改key1,key2成对应的键值对即可。

2.各字段数据生成

app_id

app_id为应用标识，到腾讯Ai平台申请项目就会得到app_id,和app_key。app_key在后续的鉴权生成时会用到。
申请项目获得密钥的接入文档https://ai.qq.com/doc/index.shtml

time_stamp

秒级时间戳
实际上就可以使用系统时间(毫秒)/1000得到需要的值。如：

String time_stamp = System.currentTimeMillis() / 1000 + "";

nonce_str

随机字符串

public static String getRandomString(int length) {String base = "abcdefghijklmnopqrstuvwxyz0123456789";     Random random = new Random();     StringBuffer sb = new StringBuffer();     for (int i = 0; i < length; i++) {     int number = random.nextInt(base.length());     sb.append(base.charAt(number));     }     return sb.toString();     }

利用随机数字去生成即可。

image的base64编码生成

base64的编码工具类在网上到处都能找得到，这里就不贴算法了，比较长
这个部分的流程主要是将图片以字节数据读入，然后再进行base64编码

byte[] imageData = FileUtil.readFileByBytes(file);
String img64 = Base64Util.encode(imageData);

sign

先看腾讯给出的说明文档：

1.字典升序排序而且还是键值对，可以想到使用java中的TreeMap去处理存储这些数据最为合适
具体签名部分代码如下：

private String generateAppSign() throws UnsupportedEncodingException {Set<String> keySet = mParams.keySet();StringBuilder sb = new StringBuilder();Iterator<String> iterator = keySet.iterator();while (iterator.hasNext()) {String key = iterator.next();String value = mParams.get(key);sb.append("&").append(key).append("=").append(URLEncoder.encode(value, "UTF-8"));}sb.deleteCharAt(0);sb.append("&app_key=").append(TencentAIConstants.APP_KEY_AI);String sign = MD5.getMD5(sb.toString());return sign;
}

代码中的mParams参数就是一个TreeMap对象，存储着除sign之外的其他键值对，利用这些键值对计算生成sign字段。

3.发起请求

发起请求这里使用okhttp，不使用HttpClient原因是安卓现在不支持使用HttpClient了，使用okhttp使用范围更广一点而且也很方便实现。主要代码：

MultipartBody.Builder builder = new MultipartBody.Builder().setType(MultipartBody.FORM);Iterator<String> iterator = mParams.keySet().iterator();while (iterator.hasNext()) {String key = iterator.next();String value = mParams.get(key);builder.addFormDataPart(key, value);}RequestBody requestBody = builder.build();Request request = new Request.Builder().header("Content-Type", "application/x-www-form-urlencoded").url(url).post(requestBody).build();OkHttpClient okHttpClient = new OkHttpClient();Response response = okHttpClient.newCall(request).execute();if (!response.isSuccessful()){return ERROR;}return response.body().string();

4.使用Builder模式写一个发起请求的类

对于这种部分参数一致，部分参数不同，且逻辑一致的需求使用Builder模式很合适。将上述列出的代码使用builder模式写一个通用的类用于各类请求再合适不过了。代码如下：

public class AiRequestBean {public static final String ERROR = "error";private TreeMap<String, String> mParams;private AiRequestBean() {mParams = new TreeMap<>();//时间戳String time_stamp = System.currentTimeMillis() / 1000 + "";//随机字符串String nonce_str = TencentAIParamsHelper.getRandomString(10);//appIdString app_id = String.valueOf(TencentAIConstants.APP_ID_AI);//将通用参数设置进map中mParams.put("app_id", app_id);mParams.put("nonce_str", nonce_str);mParams.put("time_stamp", time_stamp);}/*** TreeMap生成鉴权信息*/private String generateAppSign() throws UnsupportedEncodingException {Set<String> keySet = mParams.keySet();StringBuilder sb = new StringBuilder();Iterator<String> iterator = keySet.iterator();while (iterator.hasNext()) {String key = iterator.next();String value = mParams.get(key);sb.append("&").append(key).append("=").append(URLEncoder.encode(value, "UTF-8"));}sb.deleteCharAt(0);sb.append("&app_key=").append(TencentAIConstants.APP_KEY_AI);String sign = MD5.getMD5(sb.toString());return sign;}//发起请求public String request(String url) throws IOException {//生成签名加入到参数列表中String sign = generateAppSign();mParams.put("sign", sign);//使用okhttp发起请求MultipartBody.Builder builder = new MultipartBody.Builder().setType(MultipartBody.FORM);Iterator<String> iterator = mParams.keySet().iterator();while (iterator.hasNext()) {String key = iterator.next();String value = mParams.get(key);builder.addFormDataPart(key, value);}RequestBody requestBody = builder.build();Request request = new Request.Builder().header("Content-Type", "application/x-www-form-urlencoded").url(url).post(requestBody).build();OkHttpClient okHttpClient = new OkHttpClient();Response response = okHttpClient.newCall(request).execute();if (!response.isSuccessful()){return ERROR;}return response.body().string();}public static class Builder {private AiRequestBean targetBean;public Builder() {targetBean = new AiRequestBean();}public AiRequestBean build() {return targetBean;}public Builder addParam(String key, String value) {targetBean.mParams.put(key, value);return this;}}
}

使用方法也很简单，比如以通用ocr为例，通用ocr文字识别中不同的参数为image,对应的Api为”https://api.ai.qq.com/fcgi-bin/ocr/ocr_generalocr”

    public static final String URL4GENERALOCR  = "https://api.ai.qq.com/fcgi-bin/ocr/ocr_generalocr";
//通用ocr文字识别请求public String getGeneralOcrResult(File file) throws Exception {byte[] imageData = FileUtil.readFileByBytes(file);//准备好图片base64数据String img64 = Base64Util.encode(imageData);String jsonResult = new AiRequestBean.Builder().addParam("image", img64).build().request(TencentAIConstants.URL4GENERALOCR);return jsonResult;}

可以看到还是很方便使用的。

Demo代码链接：http://download.csdn.net/download/breeze048/10267182