pomelo-weixin-client
pomelo客户端的微信小程序实现
安装
npm install pomelo-weixin-client
或者使用单文件版,移步releases
单文件版无需使用npm,支持AMD/CMD等打包方式,可以直接require
使用
const pomelo = ; // 普通模式,用于生产环境,会生成wss://example.com/ws/3005类似的地址,需要nginx支持pomelo; // 调试模式,用于本地开发,生成普通链接ws://example.com:3005pomelo; // 浏览器调试模式,用于本地开发,使用浏览器原生WebSocket,生成普通链接ws://example.com:3005pomelo; // 如果需要多个连接实例,可以用newInstance方法生成const pomelo2 = pomelo;
具体使用方法见官方的websocket版本客户端说明
额外增加的功能:
全局监听消息(排除已用request设置回调的消息)
pomelo;
特别说明
微信仅支持wss连接(https)并且不支持自定义端口号,因此在服务器端进行额外的处理
例如以下代码:
pomelo;
实际上连接的是wss://example.com/ws/3005/
需要在服务器端将以上连接转换为ws://example.com:3005
这里提供nginx的例子:
server{ listen 443 ssl http2 default_server; listen [::]:443 ssl http2 default_server; server_name example.com; ssl on; #证书文件 ssl_certificate /etc/ssl/certs/ssl-cert.crt; #私钥文件 ssl_certificate_key /etc/ssl/private/ssl-cert.key; ssl_session_timeout 5m; ssl_protocols TLSv1 TLSv1.1 TLSv1.2; ssl_ciphers AESGCM:ALL:!DH:!EXPORT:!RC4:+HIGH:!MEDIUM:!LOW:!aNULL:!eNULL; ssl_prefer_server_ciphers on; location /ws/3005/ { proxy_pass http://127.0.0.1:3005; proxy_http_version 1.1; proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection "upgrade"; }}
License
MIT © Wang Sijie