iOS原生接口

https://www.zybuluo.com/chenhongen/note/1415975

# iOS原生接口

标签（空格分隔）：未分类

---

APP端定义一些Router协议，前端或者后端只需遵循这个协议即可调用原生的相关接口
# 一、跳转页面（iOS&安卓通用）
## 1、路由规则
sktbloom://push?ID=1001 （无参）
sktbloom://push?ID=1001&key=value&key=value&… （有参）

sktbloom 代表url schemes 固定不变
push 代表需要跳转页面
ID 代表具体跳转到哪个页面

##### ID详细说明：

|~ID|~对应的页面|~参数 |~特殊说明|
|| 1100|| 首页|| ||url = sktbloom://push?ID=1100||
|| 1200|| 社区|| ||url = sktbloom://push?ID=1200||
|| 1300|| 我的|| ||url = sktbloom://push?ID=1300||
|| 1001|| 登录页|||| url = sktbloom://push?ID=1001||
|| 1002|| 发帖页||topicId/topicName || url = sktbloom://push?ID=1002&topicId=xxx& topicName=xxx||
|| 1003|| 消息列表页|| ||url = sktbloom://push?ID=1003||
|| 1004|| 帖子详情页|| postsId ||url = sktbloom://push?ID=1004&postsId=913965717358092289||
|| 1005|| 个人主页|| userId || url = sktbloom://push?ID=1005&userId=901621548283310080 ||

##### ID范围定义：
||~ID类型 ||~关键字 ||~定义范围 ||
|| 跳转|| push || 1000~1999||
|| 待定|| 待定 || 2000~2999||
|| 待定|| 待定 || 3000~3999||

##### 其他用法：
在Safari输入：sktbloom://push?ID=1004&postsId=913965717358092289，如果你安装了bloom APP 那么也能打开app的帖子详情页面

## 2、关于分享
例如：
分享帖子详情页，给到前端对应的shareWebUrl即为：https://www.webloom.cn/bloom_h5/#/Landingpage?ID=1004&postsId=913965717358092289

前端使用sktbloom://push? 拼接 ID=1004&postsId=913965717358092289 即可
 
## 3、关于推送
例如：
需要推送帖子详情页，推送给移动端的url即为：sktbloom://push?ID=1004&postsId=913965717358092289

# 二、原生向H5注入的方法

- 用户信息
- 支付
- 分享
- 导航栏
- 图片浏览器
- 相机相册
- 刷新

## 1、用户信息
### getToken
> app端会返回cookie，cookie由token,userId,appVer,cType,deviceId,apiVer六个字段拼接而来

### getUserInfo
> 获取用户信息，app端会返回responseObject，responseObject为后端返回的json数据

## 2、支付
### popPay
> 调起支付面板
||~参数||~备注||
|| payType|| 支付类型：1002阿里，2002微信 ||
|| trigger|| 后端获取到的三方SKD参数||

## 3、分享
### !!#ff0000 showShareButton !!
> H5页面导航栏右边显示分享按钮，H5在需要的页面加载完成后调用showShareButton方法并传参数即可，不调用默认该页面不显示分享按钮， !!#ff0000 appV1.0.1版本之后废弃，请使用 “ showShareButtonConfigShareInfo ”代替!!
 
请求参数说明：
||~参数||~类型||~说明||~备注||
|| shareTitle|| json || 五种平台的分享标题 || qq/wb/wx/wxf/qqf 五种平台标题 ||
|| shareSubTitle|| String || 分享内容/子标题|| ||
|| shareImageUrl|| String || 分享图片URL|| ||
|| shareWebUrl|| String || 分享链接URL|| ||

请求示例：

```
{
"shareTitle": {
"wx": "这是分享到微信平台的title，没有什么能比和大家一起运营科技赛车公司更cool的了! ",
"wxf": "这是分享到微信朋友圈平台的title，没有什么能比和大家一起运营科技赛车公司更cool的了! ",
"qq": "这是分享到qq平台的title，没有什么能比和大家一起运营科技赛车公司更cool的了! ",
"qqf": "这是分享到qq空间平台的title，没有什么能比和大家一起运营科技赛车公司更cool的了! ",
"wb": "这是分享到微博平台的title，没有什么能比和大家一起运营科技赛车公司更cool的了! "
},
"shareSubTitle": "真的很cool耶",
"shareImageUrl": "https://img.webloom.cn/ad27296bedb755f49b48d0e346b89729.JPG?x-oss-process=image/quality,q_50",
"shareWebUrl":"https://www.webloom.cn"
}
```

### showShareButtonConfigShareInfo
> H5页面导航栏右边显示分享按钮，H5在需要的页面加载完成后调用showShareButtonConfigShareInfo方法并传参数即可，不调用默认该页面不显示分享按钮，（显示分享按钮，并配置分享信息，appV1.0.1版本之后代替showShareButton方法）
 
请求参数说明：
||~参数||~类型||~说明||~备注||
|| wx ||json|| 微信 || ||
|| wxf ||json|| 微信朋友圈|| ||
|| qq ||json|| qq|| ||
|| qqf ||json|| qq空间|| ||
|| wb ||json|| 微博|| ||

||~参数 ||~类型 ||~说明 ||~备注 ||
|| shareTitle ||String|| 分享标题 || ||
|| shareSubTitle ||String|| 分享子标题/内容|| ||
|| shareImageUrl ||String|| 分享图片|| ||
|| shareWebUrl ||String|| 分享的web链接|| ||
|| shareVideoUrl ||String|| 分享的视频网页播放地址|| ||
|| shareType ||int|| 分享类型 1、纯文字 2、图（在微博中可以是图+文+链接） 3、网页 4、视频（在微博中可以是视频+文+链接） || ||

请求示例：
```
{
"wx": {
"shareTitle": "这是分享到微信平台的title，没有什么能比和大家一起运营科技赛车公司更cool的了!",
"shareSubTitle": "真的很酷啊！！",
"shareImageUrl": "https://img.webloom.cn/ad27296bedb755f49b48d0e346b89729.JPG?x-oss-process=image/quality,q_50",
"shareWebUrl": "https://www.webloom.cn",
"shareType": 3
},
"wxf": {
"shareTitle": "这是分享到微信朋友圈平台的title，没有什么能比和大家一起运营科技赛车公司更cool的了!",
"shareSubTitle": "赛车很不错哦！！",
"shareImageUrl": "https://img.webloom.cn/ad27296bedb755f49b48d0e346b89729.JPG?x-oss-process=image/quality,q_50",
"shareWebUrl": "https://www.webloom.cn",
"shareType": 3
},
"qq": {
"shareTitle": "这是分享到qq平台的title，没有什么能比和大家一起运营科技赛车公司更cool的了!",
"shareSubTitle": "qq的小伙伴在哪里？",
"shareImageUrl": "https://img.webloom.cn/ad27296bedb755f49b48d0e346b89729.JPG?x-oss-process=image/quality,q_50",
"shareWebUrl": "https://www.webloom.cn",
"shareType": 1
},
"qqf": {
"shareTitle": "这是分享到qq空间平台的title，没有什么能比和大家一起运营科技赛车公司更cool的了!",
"shareSubTitle": "qq空间的科技赛车",
"shareImageUrl": "https://img.webloom.cn/ad27296bedb755f49b48d0e346b89729.JPG?x-oss-process=image/quality,q_50",
"shareWebUrl": "https://www.webloom.cn",
"shareType": 1
},
"wb": {
"shareTitle": "这是分享到微博平台的title，没有什么能比和大家一起运营科技赛车公司更cool的了!",
"shareSubTitle": "微博上头条了！",
"shareImageUrl": "https://img.webloom.cn/ad27296bedb755f49b48d0e346b89729.JPG?x-oss-process=image/quality,q_50",
"shareWebUrl": "https://www.webloom.cn",
"shareType": 2
}
}
```

## 4、导航栏
### showNavigationBar
> 显示导航栏，webView将从导航栏下面开始布局，默认显示导航栏
### hiddenNavigationBar
> 隐藏导航栏，在网页完全加载之后调用此方法,webView将从状态栏下面开始布局
### setNavigationBarTitle
> 设置导航栏标题，在网页完全加载之后调用此方法，如未设置，默认和前端的title一致

请求参数说明：
||~参数||~类型||~默认值||~必填||~说明||
|| title || string || ||是|| 导航栏标题 ||

## 5、图片浏览器
### previewImage
> 在新页面中全屏预览图片。预览的过程中用户可以进行保存图片操作。

请求参数说明：
||~参数||~类型||~默认值||~必填||~说明||
|| urls ||Array.<string>|| ||是|| 需要预览的图片链接列表。 ||
|| index ||string|| ||是|| 需要预览的图片下标 ||
请求示例：

```
{
"urls": [
"http://img4.duitang.com/uploads/item/201601/15/20160115231312_TWuG5.gif ",
"http://c.hiphotos.baidu.com/baike/pic/item/d1a20cf431adcbefd4018f2ea1af2edda3cc9fe5.jpg",
"http://img3.duitang.com/uploads/item/201605/28/20160528202026_BvuWP.jpeg ",
"http://77fkxu.com1.z0.glb.clouddn.com/20180131/1517367951_59939.png"
],
"index": "1"
}
```
## 6、相机相册
### chooseImage
> 从本地相册选择图片或使用相机拍照。

## 7、刷新
### pullDownRefresh
> 下拉刷新

原文地址：https://www.cnblogs.com/chglog/p/10449957.html

相关推荐