wxCard

open

addEventListener

概述

微信简介

微信 (WeChat) 是腾讯公司于2011年1月21日推出的一个为智能终端提供即时通讯服务的免费应用程序，微信支持跨通信运营商、跨操作系统平台通过网络快速发送免费（需消耗少量网络流量）语音短信、视频、图片和文字。截止到2016年第一季度，微信已经覆盖中国 90% 以上的智能手机，月活跃用户达到 5.49 亿，用户覆盖 200 多个国家、超过 20 种语言。此外，各品牌的微信公众账号总数已经超过 800 万个，移动应用对接数量超过 85000 个，微信支付用户则达到了 4 亿左右。

微信提供公众平台、朋友圈、消息推送等功能，用户可以通过“摇一摇”、“搜索号码”、“附近的人”、扫二维码方式添加好友和关注公众平台，同时微信将内容分享给好友以及将用户看到的精彩内容分享到微信朋友圈。

微信功能服务

  • 朋友圈：用户可以通过朋友圈发表文字和图片，同时可通过其他软件将文章或者音乐分享到朋友圈。用户可以对好友新发的照片进行“评论”或“赞”，用户只能看相同好友的评论或赞。
  • 语音提醒：用户可以通过语音告诉Ta提醒打电话或是查看邮件。[19]
  • 通讯录安全助手：开启后可上传手机通讯录至服务器，也可将之前上传的通讯录下载至手机。[24]
  • QQ邮箱提醒：开启后可接收来自QQ邮件的邮件，收到邮件后可直接回复或转发。[24]
  • 私信助手：开启后可接收来自QQ微博的私信，收到私信后可直接回复。[24]
  • 漂流瓶：通过扔瓶子和捞瓶子来匿名交友。
  • 查看附近的人：微信将会根据您的地理位置找到在用户附近同样开启本功能的人。（LBS功能）
  • 语音记事本：可以进行语音速记，还支持视频、图片、文字记事。
  • 微信摇一摇：是微信推出的一个随机交友应用，通过摇手机或点击按钮模拟摇一摇，可以匹配到同一时段触发该功能的微信用户，从而增加用户间的互动和微信粘度。
  • 群发助手：通过群发助手把消息发给多个人。
  • 微博阅读：可以通过微信来浏览腾讯微博内容。
  • 流量查询：微信自身带有流量统计的功能，可以在设置里随时查看微信的流量动态。
  • 游戏中心：可以进入微信玩游戏（还可以和好友比高分）例如“飞机大战”。
  • 微信公众平台：通过这一平台，个人和企业都可以打造一个微信的公众号，可以群发文字、图片、语音三个类别的内容。目前有200万公众账号。
  • 微信在IPhone、Android、Windows Phone、Symbian、BlackBerry等手机平台上都可以使用，并提供有多种语言界面。

插件概述

wxCard封装了打开微信卡券功能

使用此插件之前需先配置 config.xml 文件，方法如下

  • 名称：wx
  • 参数：urlScheme、appid、universalLink
  • 配置示例:
  <feature name="wxCard">
    <param name="urlScheme" value="wxd0d84bbf23b4a0e4"/>
    <param name="appid" value="wxd0d84bbf23b4a0e4"/>
    <param name="universalLink" value="https://bjtest.apicloud.com"/>
 </feature>

  • 字段描述:

    urlScheme：（必须配置）用于实现应用间跳转及数据交换，本应用可以启动微信客户端，也可以从微信客户端跳回本应用。urlScheme 的 value 值是从微信开放平台获取的 appid。appid 申请方法参考微信开放平台接入文档。

    appid：（必须配置）从微信开放平台获取的 appid，值与 urlScheme 相同。appid 申请方法参考微信开放平台接入文档。

    appdesc：应用附加信息，长度不超过1024字节 1.0.1版本及以后版本iOS不在支持

    universalLink：（必须配置） 仅支持iOS，微信开发者 Universal Link。

##iOS Universal Link 使用攻略

**关于 Universal Link **

Universal Links（通用链接），是苹果在iOS9之后，提供的一种“通过传统HTTP链接来跳转APP”的能力。该特性相较于传统的Custom URL Scheme方式，具备唯一、安全、私有和简单的优势。

如何使用

1.创建 entitlements 文件，YonBuilder移动开发 平台上的开发者，可通过此文件告诉编译服务器开通 Associated Domain 功能。配置方法参考论坛帖子。配置示例如下：

```js
    <?xml version="1.0" encoding="UTF-8"?>
    <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
    <plist version="1.0">
    <dict>
        <key>com.apple.developer.associated-domains</key>
        <array>
            <string>applinks:bjtest.apicloud.com</string>
        </array>
    </dict>
    </plist>
```

其中 com.apple.developer.associated-domains 对应的值applinks:bjtest.apicloud.com 是配置的你的应用的 Universal Links。详情参考 苹果文档

2.开通 Associated Domains。 登录苹果开发者账号，在左侧列表里找到 Identifiers，选中后再找到你的 Bundle ID （包名），选中该包名，配置开启其 Associated Domains 功能。如下下图所示：

illustration

3.服务器端支持苹果 Universal Links。支持方法参考 论坛帖子。

open

打开微信卡券页面

open({params}, callback(ret, err))

params

cardId：

  • 类型：字符串
  • 描述：卡券ID

extMsg：

  • 类型：字符串
  • 描述：扩展信息

callback(ret, err)

ret：

  • 类型：JSON 对象
  • 内部字段：
{
   status:true,                //布尔类型；true/false 是否成功
}

示例代码

var wxCard = api.require('wxCard');
wxCard.open({
    cardId: '',
    extMsg:''
}, function(ret, err) {});

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

addEventListener

添加监听

addEventListener(callback(ret))

callback(ret)

ret：

  • 类型：JSON 对象
  • 内部字段：
{
     errCode:0,  //数字类型；错误码
     errStrL:'',    //字符串类型；错误提示字符串
     type:0         //数字类型；响应类型 
}

示例代码

var wxCard = api.require('wxCard');
wxCard.addEventListener(function(ret) {
   api.alert({
            msg: JSON.stringify(ret)
        })
});

可用性

iOS系统

可提供的1.0.0及更高版本

是否仍需要帮助？ 请保持联络！
最后更新于 2024/12/2