【公众号开发】(4)
文章目录
- 【公众号开发】(4)
- 1. 图像文字识别功能
- 1.1 百度AI图像文字识别接口申请
- 1.2 查看文档学习如何调用百度AI
- 1.3 程序开发
- 1.3.1 导入依赖:
- 1.3.2 公众号发来post请求格式
- 1.3.3 对image类型的消息做好分支处理
- 1.3.4 访问百度AI的必要参数配置
- 1.3.5 访问百度AI(根据文档写就完事了)
- 1.3.6 封装回复消息
- 1.3.7 测试
- 2. 模板消息
- 2.1 设置所属的行业
- 2.2 获取设置的行业消息
- 2.3 发送模板消息
- 2.3.1 获得模板id
- 2.3.2 访问接口发送模板消息
- 3. 素材管理
- 3.1 上传文件资源方法
- 3.2 发送临时素材
- 3.3 获得临时素材
- 4. 二维码的生成与获取信息
- 4.1 生成带参数二维码
- 4.2 获取二维码
- 4.3 分支处理扫描二维码触发的事件
【公众号开发】(4)
1. 图像文字识别功能
我们的需求就是
实现读取图片文本信息
实现原理:
发送图片给公众号,开发者服务器会收到这个消息:
包含图片url:
1.1 百度AI图像文字识别接口申请
我们当然很难自己去实现一个图片识别功能,我们要借助强大的已有接口:
我们现在要实现的功能是图片的文字识别功能,首先我们在百度搜索一下“百度AI”:
百度AI开放平台给我们提供了很多人工智能相关的接口让我们去直接使用
登录一下(顺便实名认证):
找到满足我们需求,我们要用到的接口:
点击技术文档可以进行学习:文字识别OCR (baidu.com)
点击立即使用/在控制台前往文字识别:
创建一个应用:
我们不经常使用,所以就开通一下,来练习一下,按量计费,购买的话可以访问很久很多次,但是我觉得没啥必要
- 百度智能云-管理中心 (baidu.com)
在列表中查看信息,这些信息等一下我们的程序里是要用到的,有了这些信息,百度才允许你访问接口
1.2 查看文档学习如何调用百度AI
进入文档:
快速入门:
- 快速入门 - 文字识别OCR (baidu.com)
在里面我们可以查看如何实现这个功能
1.3 程序开发
1.3.1 导入依赖:
Maven Central: Search (sonatype.com)
<dependency>
<groupId>com.baidu.aip</groupId>
<artifactId>java-sdk</artifactId>
<version>4.16.16</version>
</dependency>
tips:版本冲突运行不了的话,可以这样排除
<exclusions> <exclusion> <groupId>org.slf4j</groupId> <artifactId>slf4j-api</artifactId> </exclusion> <exclusion> <groupId>org.slf4j</groupId> <artifactId>slf4j-simple</artifactId> </exclusion> </exclusions>
1.3.2 公众号发来post请求格式
基础消息能力 / 接收普通消息 (qq.com)
1.3.3 对image类型的消息做好分支处理
1.3.4 访问百度AI的必要参数配置
public class ImageUtils {
//设置APPID/AK/SK
public static final String APP_ID = "你的 App ID";
public static final String API_KEY = "你的 Api Key";
public static final String SECRET_KEY = "你的 Secret Key";
}
1.3.5 访问百度AI(根据文档写就完事了)
响应json的格式:
把word_result读出来就行了(其他两个一个记录id,一个结果数)
public static String getImageText(String picUrl) {
// 初始化一个AipOcr
AipOcr client = new AipOcr(APP_ID, API_KEY, SECRET_KEY);
System.out.println(picUrl);
// 调用接口
JSONObject jsonObject = client.webImageUrl(picUrl, new HashMap<String, String>());
// 解析json字符串
Map<String, Object> map = JsonUtils.jsonToMap(jsonObject.toString());
// 获取单词集
List<Map<String, Object>> wordsResult = (List<Map<String, Object>>) map.get("words_result");
if(wordsResult == null || wordsResult.size() == 0) {
return "";
}
List<String> words = new ArrayList<>();
for(Map<String, Object> m : wordsResult) {
words.add((String) m.get("words"));
}
System.out.println(words);
// 返回识别结果
return words.toString();
}
1.3.6 封装回复消息
private String handleImage(Map<String, Object> map) {
String picUrl = (String) map.get("PicUrl");
String content = ImageUtils.getImageText(picUrl);
map.put("Content", content);
TextMessage textMessage = TextMessage.getReplyTextMessage(map);
String message = XmlUtils.objectToXml(textMessage);
return message;
}
1.3.7 测试
成功啦😊~
补充,之前我们做的上拉菜单,点击里面的发送图片按钮,发送的并不是事件类型的消息:
- 点击它弹出子菜单:选择拍照或者相册选择
- 反正选择图片确认后,都相当于发送了图片类型的消息
这个只是示例,其他的自行研究,举一反三~
试玩了之后,把那个服务终止了,少花点钱🤭
2. 模板消息
在我们可以获得Access Token后就可以使用模板消息了
文档:基础消息能力 / 模板消息接口 (qq.com)
这个是公众号主动的向用户发送重要的消息
例如这种,就是模板消息
使用规则也要注意:
2.1 设置所属的行业
我们要想实现这个模板消息的发送的话,就要先设置所属的行业
参数:
- id1与id2,可以理解为主业和副业
行业编码可以在文档里查找:
public class TextModelMessage {
public static void setTradeInfo() {
String url = "https://api.weixin.qq.com/cgi-bin/template/api_set_industry" + HttpUtils.getQueryString(new HashMap<String, Object>() {{
this.put("access_token", TokenUtils.getToken());
}});
Map<String, Object> param = new HashMap<String, Object>() {{
this.put("industry_id1", "1");
this.put("industry_id2", "2");
}};
System.out.println(HttpUtils.doPost(url, JsonUtils.objectToJson(param)));
}
public static void main(String[] args) {
setTradeInfo();
}
}
结果:
🆗啦😊~
2.2 获取设置的行业消息
公众号开发这么久了,套路都差不多~
public static String getTradeInfo() {
String url = "https://api.weixin.qq.com/cgi-bin/template/get_industry" + HttpUtils.getQueryString(new HashMap<String, Object>() {{
this.put("access_token", TokenUtils.getToken());
}});
return HttpUtils.doGet(url, null);
}
public static void main(String[] args) {
//setTradeInfo();
System.out.println(getTradeInfo());
}
信息获取正确:
2.3 发送模板消息
2.3.1 获得模板id
首先我们要先获取模板id
在我们的测试公众平台界面,有这个模板消息接口:
新增测试模板:
模板消息运营规范:
基础消息能力 / 模板消息运营规范 (qq.com)
目前允许发的模板消息示例:
[微信模板消息测试 - 漂泊雪狼 - 博客园 (cnblogs.com)](https://www.cnblogs.com/weiweictgu/p/4933186.html#:~:text=目前允许发的模板消息示例 1.1资料变更类通知示例如下: 1.2政务服务类通知示例如下:,1.3物品 (含虚拟类)收取类通知示例如下: 1.4消费交易类通知示例如下:)
以一个很常见的为例子:
填入模板信息:
复制模板ID:
这里测试公众号阶段,直接这样获取模板id(此模板也只在此阶段能用),之后需要通过请求的方式获取,再回头来学!
- 基础消息能力 / 模板消息接口 (qq.com)
包括获取模板列表,删除模板,等等这些动作感兴趣的同学可以去研究一下,之后需要用到回头再学!
2.3.2 访问接口发送模板消息
data属性的值对象的各个 属性就是刚才的模板内容中的xxx.DATA:
更详细的json字符串示例:
可见,first和remark也在其中,并且属性值不仅有value(String)这个属性,还有color(String),也就是表现颜色(#六位十六进制的格式)
json字符串各个参数的介绍:
openid就是微信用户的id,这个用户肯定做了些事情我们才发模板消息给他,我们肯定有记录他的标识,也就是openid~
- 也就是这里的“微信号”
- 之后我们可以从数据库或者其他手段,也能获取到openid的,那个时候再说
小程序相关的和防止重入的这里不考虑(小程序不填了的话,其appid虽然必填,也因为miniprogram不填而不需要填写,pagepath也不需要)
返回码,简单了解即可
public static void sendModelMessage() {
String url = "https://api.weixin.qq.com/cgi-bin/message/template/send" + HttpUtils.getQueryString(new HashMap<String, Object>() {{
this.put("access_token", TokenUtils.getToken());
}});
String data =
"{" +
" \"first\":{\n" +
" \"value\":\"你好,你申请参加活动报名成功。\",\n" +
" \"color\":\"#101010\"" +
" },\n" +
" \"keyword1\":{\n" +
" \"value\":\"张三\",\n" +
" \"color\":\"#101010\"" +
" },\n" +
" \"keyword2\":{\n" +
" \"value\":\"13333333333\"\n" +
" },\n" +
" \"keyword3\": {\n" +
" \"value\":\"2023-10-21 17:43\"\n" +
" },\n" +
" \"keyword4\": {\n" +
" \"value\":\"你选择的是足球队员\"\n" +
" },\n" +
" \"remark\": {\n" +
" \"value\":\"感谢您 的使用,祝你生活愉快!\",\n" +
" \"color\":\"#FF0000\"" +
" }" +
"}";
Map<String, Object> param = new HashMap<String, Object>() {{
this.put("touser", "otfI46nw4BoHVoOjivoWmEamB494");
this.put("template_id", "jDrr4sGQBOgI7uTliXajxbaTTXMxhf2RzTXlwq3DBWY");
this.put("url", "https://blog.csdn.net/Carefree_State?type=blog");
this.put("data", JsonUtils.jsonToMap(data));
}};
// 发送请求
System.out.println(HttpUtils.doPost(url, JsonUtils.objectToJson(param)));
}
public static void main(String[] args) {
//setTradeInfo();
//System.out.println(getTradeInfo());
sendModelMessage();
}
效果:
为什么不显示首行内容、尾部/备注内容、颜色?
- 参考公告:关于规范公众号模板消息的再次公告 (qq.com)
可能是很多违规案例的出现导致的(诈骗、营销、骚扰用户等等不良行为)
点此查看违规案例
这里的data,我直接偷懒给个写死了的~
- 之后我们只需要自己将我们的模板,封装成对象,再动态地获取和设置数据进去就行了
3. 素材管理
素材管理 / 新增临时素材 (qq.com)
有时候,我们需要将一些素材上传到公众号内进行缓存,所以我们需要学习一些素材管理的内容
差不多就这样吧,之后就是向公众号服务器发送请求
3.1 上传文件资源方法
这个方法比较万能,可以解决上传资源的各个文件问题,但是文件要满足限制!
//httpClient发送携带⽂件的post请求
public static String doPostByFile(String url, Map<String,
Object> map, String localFile, String fileParamName) {
HttpPost httpPost = new HttpPost(url);
CloseableHttpClient httpClient = HttpClients.createDefault();
String resultString = "";
CloseableHttpResponse response = null;
try {
// 把⽂件转换成流对象FileBody
FileBody bin = new FileBody(new File(localFile));
MultipartEntityBuilder builder =
MultipartEntityBuilder.create();
builder.addPart(fileParamName, bin);
if (map != null) {
for (String key : map.keySet()) {
builder.addPart(key,
new StringBody((String) map.get(key),
ContentType.create("text/plain", Consts.UTF_8)));
}
}
HttpEntity reqEntity = builder.build();
httpPost.setEntity(reqEntity);
// 发起请求 并返回请求的响应
response = httpClient.execute(httpPost, HttpClientContext.create());
resultString = EntityUtils.toString(response.getEntity(), "utf-8");
} catch (Exception e) {
e.printStackTrace();
} finally {
try {
if (response != null)
response.close();
} catch (IOException e) {
e.printStackTrace();
}
}
return resultString;
}
需要的依赖:
<!--httpClient需要的依赖--> <dependency> <groupId>org.apache.httpcomponents</groupId> <artifactId>httpclient</artifactId> <version>4.5.2</version> </dependency> <!--//httpclient缓存--> <dependency> <groupId>org.apache.httpcomponents</groupId> <artifactId>httpclient-cache</artifactId> <version>4.5</version> </dependency> <!--//http的mime类型都在这⾥⾯--> <dependency> <groupId>org.apache.httpcomponents</groupId> <artifactId>httpmime</artifactId> <version>4.3.2</version> </dependency>
3.2 发送临时素材
这里以发送图片为例,其他参考文档!
public static String sendImage() {
// 构造url
String url = "https://api.weixin.qq.com/cgi-bin/media/upload" + HttpUtils.getQueryString(new HashMap<String, Object>() {{
this.put("access_token", TokenUtils.getToken());
this.put("type", "image");
}});
// 发起请求
String response = HttpUtils.doPostByFile(url, null, "D:/马图/瞪眼.jpg", "");
System.out.println(response);
return (String) JsonUtils.jsonToMap(response).get("media_id");
}
测试:
public static void main(String[] args) {
System.out.println(sendImage());
}
成功了😊:
- 这个就是临时的media_id(所有资源统一的字段)
3.3 获得临时素材
这里以发送图片为例,其他参考文档!
通过身份标识和media_id确认对于的临时资源
对于非视频消息素材,返回的就是素材的二进制序列!
- 在浏览器访问的话,会触发文件下载
public static String getImage(String mediaId) {
// 构造url
String url = "https://api.weixin.qq.com/cgi-bin/media/get" + HttpUtils.getQueryString(new HashMap<String, Object>() {{
this.put("access_token", TokenUtils.getToken());
this.put("media_id", mediaId);
}});
System.out.println(url);
return HttpUtils.doGet(url, null);
}
测试:
public static void main(String[] args) {
String ret = getImage(sendImage());
}
成功啦😊:
访问一下这个链接:
- 触发下载了
打开后,就是刚才我们发的文件:
4. 二维码的生成与获取信息
账号管理 / 生成带参数的二维码 (qq.com)
这里生成带参数的二维码,扫二维码后是跳转到公众号,是公众号的宣传手段之一
带的参数有这些:
二维码分为四类:
- QR_SCENE为 临时的整型参数值
- QR_STR_SCENE为 临时的字符串参数值
- QR_LIMIT_SCENE为 永久的整型参数值
- QR_LIMIT_STR_SCENE为 永久的字符串参数值
4.1 生成带参数二维码
反正就字面意思,我这里就不封装对象,直接写死一个data:
public static String createTicket() {
String url = "https://api.weixin.qq.com/cgi-bin/qrcode/create" + HttpUtils.getQueryString(new HashMap<String, Object>() {{
this.put("access_token", TokenUtils.getToken());
}});
//生成临时二维码的数据
// Map<String, Object> param = new HashMap<String, Object>(){{
//
// }};
String data = "{\"expire_seconds\": 3600, \"action_name\": \"QR_STR_SCENE\", \"action_info\": {\"scene\": {\"scene_str\": \"test\"}}";
// 发送请求
String ret = HttpUtils.doPost(url, data);
System.out.println(ret);
return (String) JsonUtils.jsonToMap(ret).get("ticket");
}
测试:
public static void main(String[] args) {
System.out.println(createTicket());
}
4.2 获取二维码
这里就不需要access_token了,毕竟这个二维码要拿去宣传的
public static String getTicket() {
String url = "https://mp.weixin.qq.com/cgi-bin/showqrcode" + HttpUtils.getQueryString(new HashMap<String, Object>() {{
this.put("ticket", createTicket());
}});
//System.out.println(HttpUtils.doGet(url, null));
return url;
}
测试:
public static void main(String[] args) {
System.out.println(getTicket());
}
访问成功!
4.3 分支处理扫描二维码触发的事件
基础消息能力 / 接收事件推送 (qq.com)
如果未关注,扫码后进入公众号简介界面(可选择关注),关注后触发的事件类型为:
如果已关注,扫码后就直接触发的事件类型为:
对于EventKey,就是二维码所带参数相关,可进一步做分支,这里不做演示!
编写代码处理事件:
private String handleEvent(Map<String, Object> map) {
String message = "";
// 获取event值
String event = (String) map.get("Event");
// 事件分支
switch (event) {
case "CLICK":
message = EventUtils.handleClick(map);
break;
case "VIEW":
System.out.println("view");
break;
case "SCAN":
message = EventUtils.handleScan(map);
break;
case "subscribe":
message = EventUtils.handleSubscribe(map);
break;
default:
break;
}
return message;
}
handleScan方法:
public static String handleScan(Map<String, Object> map) {
map.put("Content", "欢迎光临! " + map.get("FromUserName"));
TextMessage textMessage = TextMessage.getReplyTextMessage(map);
return XmlUtils.objectToXml(textMessage);
}
handleSubscribe方法:
public static String handleSubscribe(Map<String, Object> map) {
map.put("Content", "感谢关注! " + map.get("FromUserName"));
TextMessage textMessage = TextMessage.getReplyTextMessage(map);
return XmlUtils.objectToXml(textMessage);
}
测试:
关注状态下扫码:
非关注状态下扫码:
文章到此结束!谢谢观看
可以叫我 小马,我可能写的不好或者有错误,但是一起加油鸭🦆!代码:wx-demo · 游离态/马拉圈2023年10月 - 码云 - 开源中国 (gitee.com)