小程序基础能力~网络
(1)网络-使用说明
网络
在小程序/小游戏中使用网络相关的 API 时,需要注意下列问题,请开发者提前了解。
1. 服务器域名配置
每个微信小程序需要事先设置通讯域名,小程序只可以跟指定的域名与进行网络通信。包括普通 HTTPS 请求(wx.request)、上传文件(wx.uploadFile)、下载文件(wx.downloadFile) 和 WebSocket 通信(wx.connectSocket)。
从基础库 2.4.0 开始,网络接口允许与局域网 IP 通信,但要注意 不允许与本机 IP 通信。
从 2.7.0 开始,提供了 UDP 通信(wx.createUDPSocket),只允许跟同个局域网内的非本机 IP 通信。
配置流程
服务器域名请在 「小程序后台-设置-开发设置-服务器域名」 中进行配置,配置时需要注意:
- 域名只支持
https
(wx.request、wx.uploadFile、wx.downloadFile) 和wss
(wx.connectSocket) 协议; - 域名不能使用 IP 地址(小程序的局域网 IP 除外)或 localhost;
- 可以配置端口,如 https://myserver.com:8080,但是配置后只能向 https://myserver.com:8080 发起请求。如果向 https://myserver.com、https://myserver.com:9091 等 URL 请求则会失败。
- 如果不配置端口。如 https://myserver.com,那么请求的 URL 中也不能包含端口,甚至是默认的 443 端口也不可以。如果向 https://myserver.com:443 请求则会失败。
- 域名必须经过 ICP 备案;
- 出于安全考虑,
api.weixin.qq.com
不能被配置为服务器域名,相关API也不能在小程序内调用。 开发者应将 AppSecret 保存到后台服务器中,通过服务器使用getAccessToken
接口获取access_token
,并调用相关 API; - 对于每个接口,分别可以配置最多 20 个域名。
2. 网络请求
超时时间
- 默认超时时间和最大超时时间都是 60s;
- 超时时间可以在
app.json
或game.json
中通过networktimeout
配置。
使用限制
- 网络请求的
referer
header 不可设置。其格式固定为https://servicewechat.com/{appid}/{version}/page-frame.html
,其中{appid}
为小程序的 appid,{version}
为小程序的版本号,版本号为0
表示为开发版、体验版以及审核版本,版本号为devtools
表示为开发者工具,其余为正式版本; - wx.request、wx.uploadFile、wx.downloadFile 的最大并发限制是 10 个;
- wx.connectSockt 的最大并发限制是 5 个。
- 小程序进入后台运行后,如果 5s 内网络请求没有结束,会回调错误信息
fail interrupted
;在回到前台之前,网络请求接口调用都会无法调用。
返回值编码
- 建议服务器返回值使用 UTF-8 编码。对于非 UTF-8 编码,小程序会尝试进行转换,但是会有转换失败的可能。
- 小程序会自动对 BOM 头进行过滤(只过滤一个BOM头)。
回调函数
- 只要成功接收到服务器返回,无论
statusCode
是多少,都会进入success
回调。请开发者根据业务逻辑对返回值进行判断。
3. 常见问题
HTTPS 证书
小程序必须使用 HTTPS/WSS 发起网络请求。请求时系统会对服务器域名使用的 HTTPS 证书进行校验,如果校验失败,则请求不能成功发起。由于系统限制,不同平台对于证书要求的严格程度不同。为了保证小程序的兼容性,建议开发者按照最高标准进行证书配置,并使用相关工具检查现有证书是否符合要求。
对证书要求如下:
- HTTPS 证书必须有效;
- 证书必须被系统信任,即根证书被已系统内置
- 部署 SSL 证书的网站域名必须与证书颁发的域名一致
- 证书必须在有效期内
- 证书的信任链必需完整(需要服务器配置)
iOS
不支持自签名证书;iOS
下证书必须满足苹果 App Transport Security (ATS) 的要求;- TLS 必须支持 1.2 及以上版本。部分旧
Android
机型还未支持 TLS 1.2,请确保 HTTPS 服务器的 TLS 版本支持 1.2 及以下版本; - 部分 CA 可能不被操作系统信任,请开发者在选择证书时注意小程序和各系统的相关通告。
- Chrome 56/57 内核对 WoSign、StartCom 证书限制周知
证书有效性可以使用
openssl s_client -connect example.com:443
命令验证,也可以使用其他在线工具。
除了网络请求 API 外,小程序中其他 HTTPS
请求如果出现异常,也请按上述流程进行检查。如 https 的图片无法加载、音视频无法播放等。
跳过域名校验
在微信开发者工具中,可以临时开启 开发环境不校验请求域名、TLS版本及HTTPS证书
选项,跳过服务器域名的校验。此时,在微信开发者工具中及手机开启调试模式时,不会进行服务器域名的校验。
在服务器域名配置成功后,建议开发者关闭此选项进行开发,并在各平台下进行测试,以确认服务器域名配置正确。
如果手机上出现 “打开调试模式可以发出请求,关闭调试模式无法发出请求” 的现象,请确认是否跳过了域名校验,并确认服务器域名和证书配置是否正确。
(2)网络-局域网通信
局域网通信
基础库 2.4.0 提供了 wx.startLocalServiceDiscovery 等一系列 mDNS API,可以用来获取局域网内提供 mDNS 服务的设备的 IP。 wx.request/wx.connectSocket/wx.uploadFile/wx.downloadFile 的 url 参数允许为 ${IP}:${PORT}/${PATH}
的格式,当且仅当 IP 与手机 IP 处在同一网段且不与本机 IP 相同(一般来说,就是同一局域网,如连接在同一个 wifi 下)时,请求/连接才会成功。
在这种情况下,不会进行安全域的校验,不要求必须使用 https/wss,也可以使用 http/ws。
wx.request({url: 'http://10.9.176.40:828' // 省略其他参数 }) wx.connectSocket({ url: 'ws://10.9.176.42:828' // 省略其他参数 })
基础库 2.7.0 开始,提供了 wx.createUDPSocket 接口用于进行 UDP 通信。通信规则同上,仅允许同一局域网下的非本机 IP。
mDNS
目前小程序只支持通过 mDNS 协议获取局域网内其他设备的 IP。iOS 上 mDNS API 的实现基于 Bonjour,Android 上则是基于 Android 系统接口。
serviceType
发起 mDNS 服务搜索 wx.startLocalServiceDiscovery 的接口有 serviceType 参数,指定要搜索的服务类型。
serviceType 的格式和规范,iOS Bonjour Overview 在 Bonjour Names for Existing Service Types 有提及。
Android 文档 对此也有提及。
.
.
转载于:https://www.cnblogs.com/jianxian/p/11106953.html
小程序基础能力~网络相关推荐
- 《微信小程序-基础篇》初识微信小程序
大家好,好久不见了,前段时间各种原因分享不稳定,后面一段时间内参与了主站的原力计划,请麻烦各位支持一下,万分感谢- 本系列将从零开始介绍微信小程序的开发,介绍完基础以后会实际同步开发一个微信小程序的项 ...
- 微信小程序基础(全家福01)
微信小程序基础 目标 能够知道如何创建小程序项目 能够清除小程序项目的基本组成结构 能够知道小程序页面有几个部分组成 能够知道小程序中常见的组件如何使用 能够知道小程序如何进行协同开发和发布 讲解目录 ...
- 微信官方小程序基础教程 - 代码构成
在上一章中,我们通过开发者工具快速创建了一个 QuickStart 项目.你可以留意到这个项目里边生成了不同类型的文件: .json 后缀的 JSON 配置文件 .wxml 后缀的 WXML 模板文件 ...
- 微信小程序基础学习笔记Day01
学习目标:微信小程序基础Day01 今日目标: 能够知道如何创建小程序项目 能够清楚小程序项目的基本组成结构 能够知道小程序页面由几部分组成 能够知道小程序中常见的组件如何使用 能够知道小程序如何进行 ...
- 每日优鲜小程序基础组件介绍
每日优鲜小程序基础组件介绍 1.基础组件介绍 2.基础组件的结构与作用 3.基础组件的接入方法 初次引入 初始化 更新与维护 基础组件接入 1.基础组件介绍 小程序基础组件基于每日优鲜主商城小程序业务 ...
- 小程序 (基础认识)
简单组件 text 文本view 区域button 按钮input 表单image 图片include 包含import 导入<web-view> 导入html页面 模板语法 文本渲染 { ...
- 小程序新能力来了!可通过公众号底部广告位推广
11月9日,在2017腾讯全球合作伙伴大会上,微信开放平台基础部副总经理胡仁杰披露了小程序的最新情况:小程序目前覆盖了200多个细分行业,月访问人数最多的小程序行业类别是交通出行.电商平台.工具.生活 ...
- 微信小程序基础学习笔记Day02
学习目标:微信小程序基础Day02 今日目标: 能够使用 WXML 模板语法渲染页面结构 能够使用 WXSS 样式美化页面结构 能够使用 app.json 对小程序进行全局性配置 能够使用 page. ...
- 视频教程-2020最新微信小程序基础+实战精讲视频-微信开发
2020最新微信小程序基础+实战精讲视频 负责过多个软件项目的研发.设计和管理工作,拥有项目管理师认证.项目监理师中级认证.出版过的图书有<微信小程序开发图解案例教程><Axure ...
最新文章
- Linux 学习手记(6): 磁盘、分区、MBR与GPT
- Android Studio Emulator 提示 “/dev/kvm is not found” 解决办法
- LQ训练营(C++)学习笔记_枚举算法
- [NOI2012]美食节
- 搭建Pxe服务器无人听应答全自动网络安装VMWare esxi 6.0系统
- 单片机c语言字符,单片机C语言中变量的定义方法解析
- 【软件测试】验收测试是以最终用户为主的测试
- python 装饰器常见场景与用法
- Elastic 7.13.0 版重磅发布:在 Elastic 上搜索和存储更多数据
- Cow Hopscotch G
- ubuntu 检测到外接显示器 但依然黑屏
- http协议网站配置SSL证书实现全站https协议
- 【目标跟踪】|Exemplar Transformers
- 华为设备配置PoE功能
- 《MATLAB 神经网络43个案例分析》:第19章 基于SVM的手写字体识别
- UBT27:ubuntu安装VMware16
- html中的disabled属性的使用方式
- 带你了解什么是GOTS有机纺织品认证
- mongodb的聚合函数的$redact方法运用。
- vue3+axios:图片链接转换成二进制文件流后并提交服务器
热门文章
- ## __VA_ARGS__ ... 宏和可变参数
- 消息驱动 微服务器,消息驱动的微服务-Spring Cloud Stream整合RocketMQ
- try...catch()
- xgboost分类_XGBoost(Extreme Gradient Boosting)
- python图像下采样_[Python图像处理]十二.图像向下取样和向上取样
- 二十七、PHP框架Laravel学习笔记——模型的多对多关联
- LeetCode 2065. 最大化一张图中的路径价值(DFS)
- Scala 入门1(变量、分支循环、函数)
- LeetCode 967. 连续差相同的数字(BFS/DFS)
- LeetCode 1548. The Most Similar Path in a Graph(动态规划)