添加 urlscheme,判断某个App是否安装并唤醒此App,获取第三方App唤醒自己的App时传入的自定义参数。
1、若需要使用判断第三方App是否安装和唤醒第三方App功能,因iOS限制,需要添加白名单后才能正确使用,使用此插件前需要得到第三方App的urlscheme,并在添加插件时,传入参数APP_WHITE_LIST中。支持传入多个App的urlscheme,以逗号分隔,例如:aschemeurl,bschemeurl
2、若需要第三方App唤醒自己的App的功能, 则需要添加urlscheme,以供第三方App唤醒,在添加插件时需要将urlscheme传入参数URL_SCHEME中,每个包名都有一个可以唯一标识的urlscheme;
3、若需要获取第三方App唤醒自己App时传入的自定义参数,则需要注册监听,插件在拿到参数后,回调给此监听方法。
| 客户端 | Android | iOS |
|---|---|---|
| 支持说明 | 支持 | 支持 |
| API名称 | 说明 |
|---|---|
| check | 判断某个App是否安装 |
| openApp | 启动第三方应用 |
| registerCallback | 注册监听 |
使用MAppAvailability需要注意:
添加此插件时必需设置插件参数`URL_SCHEME`与`APP_WHITE_LIST`
在接收参数前需注册监听registerCallback;
示例:应用B唤醒应用A,同时传入自定义参数:"orderId=100&price=10.0"。应用A收到后返回应用B并传入自定义参数:"{id:123456}"。
配置:
应用A在添加此插件时,通过插件参数`URL_SCHEME`注册urlscheme(appa);通过插件参数`APP_WHITE_LIST`注册urlscheme (appb);
应用B在添加此插件时,通过插件参数`URL_SCHEME`注册urlscheme(appb);通过插件参数`APP_WHITE_LIST`注册urlscheme (appa);
调用步骤:
应用B与应用A在接收参数前注册监听registerCallback;
1.应用B通过插件方法`check`判断手机是否已经安装应用A;若安装则可通过插件方法`openApp(appa://orderId=100&price=10.0)`唤醒应用A;
2.应用A在registerCallback中得到应用B传入的自定义参数;
3.应用A通过插件方法`check`判断手机是否已经安装应用B;若安装则可通过插件方法`openApp(appb://{id:123456})`唤醒应用b;