微信内置浏览器的JsAPI(WeixinJSBridge续)[转载]
原文地址: http://www.baidufe.com/item/f07a3be0b23b4c9606bb.html
之前有写过几篇关于微信内置浏览器(WebView)中特有的Javascript API(Javascript Interface)的文章,不过随着微信官方的调整,部分API已经不能直接使用,比如类似直接分享到朋友圈 WeixinJSBridge.invoke('shareTimeline',data,callback) 这样的功能,直接调用,会得到一个访问拒绝的response。后来重新调研了下,整理出来了一个WeixinAPI的Javascript类库,分享出来,如果你对微信公众平台开发感兴趣,应该对你有用。
/**!
* 微信内置浏览器的Javascript API,功能包括:
*
* 1、分享到微信朋友圈
* 2、分享给微信好友
* 3、分享到腾讯微博
* 4、隐藏/显示右上角的菜单入口
* 5、隐藏/显示底部浏览器工具栏
* 6、获取当前的网络状态
* 7、调起微信客户端的图片播放组件
*
* @author zhaoxianlie(http://www.baidufe.com)
*/
var WeixinApi = ( function () {
/* 这里省略了一堆代码……下面直接看调用接口 */
return {
ready :wxJsBridgeReady,
shareToTimeline :weixinShareTimeline,
shareToWeibo :weixinShareWeibo,
shareToFriend :weixinSendAppMessage,
showOptionMenu :showOptionMenu,
hideOptionMenu :hideOptionMenu,
showToolbar :showToolbar,
hideToolbar :hideToolbar,
getNetworkType :getNetworkType,
imagePreview :imagePreview
};
});
|
下面,我们先来看一下这些API都应该怎么使用,先从最简单的入手。
1、假如我希望一打开网页后,就隐藏掉右上角的PopUp菜单入口,并且隐藏掉浏览器下方的工具栏,同时还要获得当前的网络状态,那么,我们的代码可以这样来写:
// 所有功能必须包含在 WeixinApi.ready 中进行
WeixinApi.ready( function (Api){
// 隐藏右上角popup菜单入口
Api.hideOptionMenu();
// 隐藏浏览器下方的工具栏
Api.hideToolbar();
// 获取网络状态
Api.getNetworkType( function (network){
// 拿到 network 以后,做任何你想做的事
});
});
|
如示例代码中的注释所示,所有的功能执行必须放在 WeixinApi.ready 方法中执行,就好比你用jQuery的时候,通常都需要使用 jQuery(document).ready(function(){ }) 一样。为什么要这样做?相信不用我解释大家都能明白,因为我们必须要保证在执行这些方法的时候,WeixinJsBridge API已经被加入到WebView上了!
2、再来看一个有关分享的例子,假如用户在阅读我的文章(或在使用我的产品)的过程中,发现它很有意思或有价值,一般都会将其收藏或分享(给好友、朋友圈、微博等)出去,那现在我就希望能监测到用户的分享行为,比如:自定义用户可分享的内容、甚至是在用户分享之、分享被取消、分享失败、分享成功、以及整个分享操作过程结束,我们都去做点儿什么。那么,这个代码我们可以这样来写:
// 所有功能必须包含在 WeixinApi.ready 中进行
WeixinApi.ready( function (Api){
// 微信分享的数据
var wxData = {
"imgUrl" : 'http://www.baidufe.com/fe/blog/static/img/weixin-qrcode-2.jpg' ,
"link" : 'http://www.baidufe.com' ,
"desc" : '大家好,我是Alien,Web前端&Android客户端码农,喜欢技术上的瞎倒腾!欢迎多交流' ,
"title" : "大家好,我是赵先烈"
};
// 分享的回调
var wxCallbacks = {
// 分享操作开始之前
ready: function () {
// 你可以在这里对分享的数据进行重组
},
// 分享被用户自动取消
cancel: function (resp) {
// 你可以在你的页面上给用户一个小Tip,为什么要取消呢?
},
// 分享失败了
fail: function (resp) {
// 分享失败了,是不是可以告诉用户:不要紧,可能是网络问题,一会儿再试试?
},
// 分享成功
confirm: function (resp) {
// 分享成功了,我们是不是可以做一些分享统计呢?
},
// 整个分享过程结束
all: function (resp) {
// 如果你做的是一个鼓励用户进行分享的产品,在这里是不是可以给用户一些反馈了?
}
};
// 用户点开右上角popup菜单后,点击分享给好友,会执行下面这个代码
Api.shareToFriend(wxData, wxCallbacks);
// 点击分享到朋友圈,会执行下面这个代码
Api.shareToTimeline(wxData, wxCallbacks);
// 点击分享到腾讯微博,会执行下面这个代码
Api.shareToWeibo(wxData, wxCallbacks);
});
|
3、当然,如果你的业务需求相当复杂,比如,你的产品就是一个微信网页游戏(类似“2048数字游戏微信版”),你希望用户分享出去的数据是一个网页截屏、或者需要将用户当前的游戏状态回传到服务器动态生成可分享的内容;那么这种情况我们又该怎么做呢?来看下面这个示例代码吧:
// 所有功能必须包含在 WeixinApi.ready 中进行
WeixinApi.ready( function (Api){
// 分享的回调
var wxCallbacks = {
// 分享过程需要异步执行
async : true ,
// 分享操作开始之前
ready: function () {
var self = this ;
// 假设你需要在这里发一个 ajax 请求去获取分享数据
$.post(yourServerUrl,yourPostData, function (responseData){
// 可以解析reponseData得到wxData
var wxData = responseData;
// 调用dataLoaded方法,会自动触发分享操作
// 注意,当且仅当 async为true时,wxCallbacks.dataLoaded才会被初始化,并调用
self.dataLoaded(wxData);
});
}
/* cancel、fail、confirm、all 方法同示例2,此处略掉 */
};
// 用户点开右上角popup菜单后,点击分享给好友,会执行下面这个代码
Api.shareToFriend({}, wxCallbacks);
});
|
唯一的区别就是在wxCallbacks中,增加了配置项async为true,表示这个分享过程是异步调用的,其实就是指的ready方法异步执行,在这种情况下,我们需要在ready方法中显式地调用wxCallbacks的dataLoaded方法,以保证分享过程能继续往下执行。也许你会发现,这个wxCallbacks中,根本就没有配置dataLoaded方法啊!是的,当async为true时,WeixinApi中我会自动对其进行初始化,dataLoaded方法需要一个参数,表示需要分享出去的数据!
4、当然,如果你非要去配置dataLoaded方法,也是没有问题的,你的配置也会被执行,不会被覆盖,执行顺序是:用户配置优先。
上面是直接给出使用方法,也许你现在开始关心每个方法的参数列表是什么样的了?我们以分享到朋友圈的方法为例,来看看参数都有哪些配置项:
/**
* 分享到微信朋友圈
* @param {Object} data 待分享的信息
* @p-config {String} appId 公众平台的appId(服务号可用)
* @p-config {String} imageUrl 图片地址
* @p-config {String} link 链接地址
* @p-config {String} desc 描述
* @p-config {String} title 分享的标题
*
* @param {Object} callbacks 相关回调方法
* @p-config {Boolean} async ready方法是否需要异步执行,默认false
* @p-config {Function} ready(argv) 就绪状态
* @p-config {Function} dataLoaded(data) 数据加载完成后调用,async为true时有用
* @p-config {Function} cancel(resp) 取消
* @p-config {Function} fail(resp) 失败
* @p-config {Function} confirm(resp) 成功
* @p-config {Function} all(resp) 无论成功失败都会执行的回调
*/
WeixinApi.shareToTimeline(data,callbacks);
|
分享给微信好友以及分享到腾讯微博的参数列表都一样,这里就不罗列了。
5、如果你的文章中有很多图片,那么,点击图片直接调起微信客户端自带的图片播放组件,那必然是一件好事;对此,你可以这样来做:
// 调起微信客户端的图片播放组件进行播放
WeixinApi.ready( function (Api){
var srcList = [];
$.each($( 'img' ), function (i,item){
if (item.src) {
srcList.push(item.src);
$(item).click( function (e){
// 通过这个API就能直接调起微信客户端的图片播放组件了
Api.imagePreview( this .src,srcList);
});
}
});
});
|
就这么一段儿简单的代码,一切都搞定了!不过,需要指出的是,Api.imagePreview的参数是会进行强检测的:
/**
* 调起微信Native的图片播放组件。
* 这里必须对参数进行强检测,如果参数不合法,直接会导致微信客户端crash
*
* @param {String} curSrc 当前播放的图片地址
* @param {Array} srcList 图片地址列表
*/
function imagePreview(curSrc,srcList) ;
|
需要指出的是,微信公众平台对Android、iOS平台支持力度不统一,比较费劲,具体有:
iOS平台下,分享出去的数据wxData中,imageUrl可以是DataURI格式的;但在Android平台下,必须是全路径的图片地址
iOS平台下,分享的回调callback基本全都可以得到执行;但在Android平台下,分享到微信朋友圈的callback无法得到执行(ready方法除外)
iOS平台下,无法在非mp.weixin.qq.com域下的页面中通过WeixinJSBridge.invoke('profile')的方式打开某微信号的资料页面;Android平台下则可以通过<a href="weixin://contacts/profile/微信ID">的方式打开资料页;WinPhone下,则是通过<a href="weixin://profile/微信ID">的方式打开。
期待官方能早日实现各平台API的统一吧!!!
至于API内部是怎么实现的,如果感兴趣,那就看源码吧,使用过程中如遇到什么Bug,请来这里反馈。
为了便于Api的维护与共享,已将其放到Github上了,大家这里走起:https://github.com/zxlie/WeixinApi
微信内置浏览器的JsAPI(WeixinJSBridge续)[转载]相关推荐
- 微信内置浏览器的JsAPI(WeixinJSBridge续)
之前有写过几篇关于微信内置浏览器(WebView)中特有的Javascript API(Javascript Interface)的文章,不过随着微信官方的调整,部分API已经不能直接使用,比如类似直 ...
- 微信内置浏览器的JsAPI(WeixinJSBridge)
之前有写过几篇关于微信内置浏览器(WebView)中特有的Javascript API(Javascript Interface)的文章,不过随着微信官方的调整,部分API已经不能直接使用,比如类似直 ...
- 微信内置浏览器私有接口WeixinJSBridge的常用方法
关闭当前页面,回到对话窗口 onBackCloseWindow()function onBackCloseWindow() { //当点击返回键时,不返回到上一页,而是直接关闭微信浏览器pushHis ...
- 微信公众平台 - 微信内置浏览器 WeixinJSBridge.invoke(‘xxx‘) API 报错:system:access_denied(常见于微信支付、分享朋友圈/转发好友等功能)解决方案
前言 场景描述:做公众号网页项目,在微信内置浏览器中运行自己的 H5 网站,需要接入微信支付.微信分享等其他能力,因此使用 WeixinJSBridge 这个 API,不料却发生报错. 如下报错所示, ...
- CocosCreator H5 微信内置浏览器调起微信支付
CocosCreator H5 微信内置浏览器调起微信支付 先来看看效果图 微信公众平台相关文档传送门https://mp.weixin.qq.com/wiki?t=resource/res_main ...
- 正则表达式获取url后面的参数截取微信支付code值(微信内置浏览器里使用微信支付)
需求是在移动端的微信内置浏览器里使用微信支付,需要跳转到一个自定义的页面去,获取code值,支付成功之后,还要跳转回去原来的页面. url格式: http://xxx.com/?code=061NnY ...
- 使用微信内置浏览器预览图片
在微信H5开发中预览图片,可以使用其他的一些图片预览插件,但是这样却不能把其中的某张图片发送给好友.对于 这种情况可以使用微信内置浏览器图片预览功能,就可以解决这个问题.不说废话直接看代码: 1.首先 ...
- JoshChen判断是否微信内置浏览器访问【转载】
在进行微信公众账号开发的时候,其中很大一块是微站点的开发,我们需要知道当前的浏览器是微信内置的浏览器,那么如何判断呢? 微信内置浏览器的 User Agent 如何判断微信内置浏览器,首先需要获取微信 ...
- 微信内置浏览器点击“返回”关闭窗口
场景:开发微信内的H5活动,需要进行微信授权,我们采用的是在一个静态页面(只有js,所以是个空白页面)内进行授权,授权后再跳转到活动主页. 客户需求:从活动主页返回时不显示这个授权页面(空白页面),直 ...
最新文章
- iOS Ruby出现问题,导致无法安装Pod
- 【NSGAII】基于NSGAII的多目标优化算法的MATLAB仿真
- 【NLP】可交互的 Attention 可视化工具!我的Transformer可解释性有救了?
- Qt for ios / Qt for Android 设置透明状态栏
- 超级组合:用户中心+云平台
- hierarchy change in CRM - step2 outbound R3AUIBASE queue
- 基于python的聊天室_Python实现文字聊天室
- python中set函数作用如何自己用代码实现_Python进阶开发之元类编程
- matlab中如何调用gpu进行并行计算_极致安卓-Termux/Aid learning开启WebGL手机GPU并行计算...
- 【深度学习框架】Tensorflow Session.run()函数的进一步理解
- 在Unity编辑器中开发遇到问题BUG如何调试解决?
- 生物特征验证是什么意思
- 中国条码解码器市场趋势报告、技术动态创新及市场预测
- 6.4 First Missing Positive --- 图解
- @+保留关键字当标识
- Windows Server 2012 2R服务器版本域控制器的安装及域环境的搭建(内有镜像下载)...
- 有没有五金产品展开计算机软件,拆单软件功能介绍
- 华硕 tuf b360 efi_1935MHz凶猛上天!ROG STRIX RTX 3070图赏-华硕,RTX 3070,图赏 ——快科技(驱动之家旗下媒体)-...
- swfupload java实例_swfupload例子
- 转载了别人的cocos2d-x的学习笔记
热门文章
- Python lambda 关键字
- 利用SparkSQL(java版)将离线数据或实时流数据写入hive的用法及坑点
- CommonsMultipartFile 转为 File 类型
- jsp:include page= /路径
- sublime text3 格式化html代码
- Dell 2950服务器CPU-E1422错误解决方法
- Jsp页面中常用的EL表达式
- Socket网络通讯_TCP协议
- mac启动本地redis_通过 Laravel Sail 构建基于 Docker 的本地开发环境
- 两边放动物对战守城的游戏_集合啦!动物森友会定制周边;百战天虫 大混战发布...