iOS原生接口

印度阿三17 2019-02-28

展開全文

APP端定義一些Router協(xié)議，前端或者后端只需遵循這個(gè)協(xié)議即可調(diào)用原生的相關(guān)接口

# 一、跳轉(zhuǎn)頁(yè)面（iOS&安卓通用）
## 1、路由規(guī)則
sktbloom://push?ID=1001 （無(wú)參）
sktbloom://push?ID=1001&key=value&key=value&… （有參）

sktbloom 代表url schemes 固定不變
push 代表需要跳轉(zhuǎn)頁(yè)面
ID 代表具體跳轉(zhuǎn)到哪個(gè)頁(yè)面

##### ID詳細(xì)說(shuō)明：

|~ID|~對(duì)應(yīng)的頁(yè)面|~參數(shù) |~特殊說(shuō)明|
|| 1100|| 首頁(yè)|| ||url = sktbloom://push?ID=1100||
|| 1200|| 社區(qū)|| ||url = sktbloom://push?ID=1200||
|| 1300|| 我的|| ||url = sktbloom://push?ID=1300||
|| 1001|| 登錄頁(yè)|||| url = sktbloom://push?ID=1001||
|| 1002|| 發(fā)帖頁(yè)||topicId/topicName || url = sktbloom://push?ID=1002&topicId=xxx& topicName=xxx||
|| 1003|| 消息列表頁(yè)|| ||url = sktbloom://push?ID=1003||
|| 1004|| 帖子詳情頁(yè)|| postsId ||url = sktbloom://push?ID=1004&postsId=913965717358092289||
|| 1005|| 個(gè)人主頁(yè)|| userId || url = sktbloom://push?ID=1005&userId=901621548283310080 ||

##### ID范圍定義：
||~ID類型 ||~關(guān)鍵字 ||~定義范圍 ||
|| 跳轉(zhuǎn)|| push || 1000~1999||
|| 待定|| 待定 || 2000~2999||
|| 待定|| 待定 || 3000~3999||

##### 其他用法：
在Safari輸入：sktbloom://push?ID=1004&postsId=913965717358092289，如果你安裝了bloom APP 那么也能打開app的帖子詳情頁(yè)面

## 2、關(guān)于分享
例如：
分享帖子詳情頁(yè) ，給到前端對(duì)應(yīng)的shareWebUrl即為：https://www./bloom_h5/#/Landingpage?ID=1004&postsId=913965717358092289

前端使用sktbloom://push? 拼接 ID=1004&postsId=913965717358092289 即可
 
## 3、關(guān)于推送
例如：
需要推送帖子詳情頁(yè) ，推送給移動(dòng)端的url即為：sktbloom://push?ID=1004&postsId=913965717358092289

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

- 用戶信息
- 支付
- 分享
- 導(dǎo)航欄
- 圖片瀏覽器
- 相機(jī)相冊(cè)
- 刷新

## 1、用戶信息
### getToken
> app端會(huì)返回cookie，cookie由token,userId,appVer,cType,deviceId,apiVer六個(gè)字段拼接而來(lái)

### getUserInfo
> 獲取用戶信息，app端會(huì)返回responseObject，responseObject為后端返回的json數(shù)據(jù)

## 2、支付
### popPay
> 調(diào)起支付面板
||~參數(shù)||~備注||
|| payType|| 支付類型：1002阿里，2002微信 ||
|| trigger|| 后端獲取到的三方SKD參數(shù)||

## 3、分享
### !!#ff0000 showShareButton !!
> H5頁(yè)面導(dǎo)航欄右邊顯示分享按鈕，H5在需要的頁(yè)面加載完成后調(diào)用showShareButton方法并傳參數(shù)即可，不調(diào)用默認(rèn)該頁(yè)面不顯示分享按鈕， !!#ff0000 appV1.0.1版本之后廢棄，請(qǐng)使用 “ showShareButtonConfigShareInfo ”代替!!
 
請(qǐng)求參數(shù)說(shuō)明：
||~參數(shù)||~類型||~說(shuō)明||~備注||
|| shareTitle|| json || 五種平臺(tái)的分享標(biāo)題 || qq/wb/wx/wxf/qqf 五種平臺(tái)標(biāo)題 ||
|| shareSubTitle|| String || 分享內(nèi)容/子標(biāo)題|| ||
|| shareImageUrl|| String || 分享圖片URL|| ||
|| shareWebUrl|| String || 分享鏈接URL|| ||

請(qǐng)求示例：

```
{
"shareTitle": {
"wx": "這是分享到微信平臺(tái)的title，沒有什么能比和大家一起運(yùn)營(yíng)科技賽車公司更c(diǎn)ool的了! ",
"wxf": "這是分享到微信朋友圈平臺(tái)的title，沒有什么能比和大家一起運(yùn)營(yíng)科技賽車公司更c(diǎn)ool的了! ",
"qq": "這是分享到qq平臺(tái)的title，沒有什么能比和大家一起運(yùn)營(yíng)科技賽車公司更c(diǎn)ool的了! ",
"qqf": "這是分享到qq空間平臺(tái)的title，沒有什么能比和大家一起運(yùn)營(yíng)科技賽車公司更c(diǎn)ool的了! ",
"wb": "這是分享到微博平臺(tái)的title，沒有什么能比和大家一起運(yùn)營(yíng)科技賽車公司更c(diǎn)ool的了! "
},
"shareSubTitle": "真的很cool耶",
"shareImageUrl": "https://img./ad27296bedb755f49b48d0e346b89729.JPG?x-oss-process=image/quality,q_50",
"shareWebUrl":"https://www."
}
```

### showShareButtonConfigShareInfo
> H5頁(yè)面導(dǎo)航欄右邊顯示分享按鈕，H5在需要的頁(yè)面加載完成后調(diào)用showShareButtonConfigShareInfo方法并傳參數(shù)即可，不調(diào)用默認(rèn)該頁(yè)面不顯示分享按鈕，（顯示分享按鈕，并配置分享信息，appV1.0.1版本之后代替showShareButton方法）
 
請(qǐng)求參數(shù)說(shuō)明：
||~參數(shù)||~類型||~說(shuō)明||~備注||
|| wx ||json|| 微信 || ||
|| wxf ||json|| 微信朋友圈|| ||
|| qq ||json|| qq|| ||
|| qqf ||json|| qq空間|| ||
|| wb ||json|| 微博|| ||

||~參數(shù) ||~類型 ||~說(shuō)明 ||~備注 ||
|| shareTitle ||String|| 分享標(biāo)題 || ||
|| shareSubTitle ||String|| 分享子標(biāo)題/內(nèi)容|| ||
|| shareImageUrl ||String|| 分享圖片|| ||
|| shareWebUrl ||String|| 分享的web鏈接|| ||
|| shareVideoUrl ||String|| 分享的視頻網(wǎng)頁(yè)播放地址|| ||
|| shareType ||int|| 分享類型 1、純文字 2、圖（在微博中可以是圖文鏈接） 3、網(wǎng)頁(yè) 4、視頻（在微博中可以是視頻文鏈接） || ||

請(qǐng)求示例：
```
{
"wx": {
"shareTitle": "這是分享到微信平臺(tái)的title，沒有什么能比和大家一起運(yùn)營(yíng)科技賽車公司更c(diǎn)ool的了!",
"shareSubTitle": "真的很酷?。?！",
"shareImageUrl": "https://img./ad27296bedb755f49b48d0e346b89729.JPG?x-oss-process=image/quality,q_50",
"shareWebUrl": "https://www.",
"shareType": 3
},
"wxf": {
"shareTitle": "這是分享到微信朋友圈平臺(tái)的title，沒有什么能比和大家一起運(yùn)營(yíng)科技賽車公司更c(diǎn)ool的了!",
"shareSubTitle": "賽車很不錯(cuò)哦??！",
"shareImageUrl": "https://img./ad27296bedb755f49b48d0e346b89729.JPG?x-oss-process=image/quality,q_50",
"shareWebUrl": "https://www.",
"shareType": 3
},
"qq": {
"shareTitle": "這是分享到qq平臺(tái)的title，沒有什么能比和大家一起運(yùn)營(yíng)科技賽車公司更c(diǎn)ool的了!",
"shareSubTitle": "qq的小伙伴在哪里？",
"shareImageUrl": "https://img./ad27296bedb755f49b48d0e346b89729.JPG?x-oss-process=image/quality,q_50",
"shareWebUrl": "https://www.",
"shareType": 1
},
"qqf": {
"shareTitle": "這是分享到qq空間平臺(tái)的title，沒有什么能比和大家一起運(yùn)營(yíng)科技賽車公司更c(diǎn)ool的了!",
"shareSubTitle": "qq空間的科技賽車",
"shareImageUrl": "https://img./ad27296bedb755f49b48d0e346b89729.JPG?x-oss-process=image/quality,q_50",
"shareWebUrl": "https://www.",
"shareType": 1
},
"wb": {
"shareTitle": "這是分享到微博平臺(tái)的title，沒有什么能比和大家一起運(yùn)營(yíng)科技賽車公司更c(diǎn)ool的了!",
"shareSubTitle": "微博上頭條了！",
"shareImageUrl": "https://img./ad27296bedb755f49b48d0e346b89729.JPG?x-oss-process=image/quality,q_50",
"shareWebUrl": "https://www.",
"shareType": 2
}
}
```

## 4、導(dǎo)航欄
### showNavigationBar
> 顯示導(dǎo)航欄，webView將從導(dǎo)航欄下面開始布局，默認(rèn)顯示導(dǎo)航欄
### hiddenNavigationBar
> 隱藏導(dǎo)航欄，在網(wǎng)頁(yè)完全加載之后調(diào)用此方法,webView將從狀態(tài)欄下面開始布局
### setNavigationBarTitle
> 設(shè)置導(dǎo)航欄標(biāo)題，在網(wǎng)頁(yè)完全加載之后調(diào)用此方法，如未設(shè)置，默認(rèn)和前端的title一致

請(qǐng)求參數(shù)說(shuō)明：
||~參數(shù)||~類型||~默認(rèn)值||~必填||~說(shuō)明||
|| title || string || ||是|| 導(dǎo)航欄標(biāo)題 ||

## 5、圖片瀏覽器
### previewImage
> 在新頁(yè)面中全屏預(yù)覽圖片。預(yù)覽的過(guò)程中用戶可以進(jìn)行保存圖片操作。

請(qǐng)求參數(shù)說(shuō)明：
||~參數(shù)||~類型||~默認(rèn)值||~必填||~說(shuō)明||
|| urls ||Array.<string>|| ||是|| 需要預(yù)覽的圖片鏈接列表。 ||
|| index ||string|| ||是|| 需要預(yù)覽的圖片下標(biāo) ||
請(qǐng)求示例：

```
{
"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./20180131/1517367951_59939.png"
],
"index": "1"
}
```
## 6、相機(jī)相冊(cè)
### chooseImage
> 從本地相冊(cè)選擇圖片或使用相機(jī)拍照。

本站是提供個(gè)人知識(shí)管理的網(wǎng)絡(luò)存儲(chǔ)空間，所有內(nèi)容均由用戶發(fā)布，不代表本站觀點(diǎn)。請(qǐng)注意甄別內(nèi)容中的聯(lián)系方式、誘導(dǎo)購(gòu)買等信息，謹(jǐn)防詐騙。如發(fā)現(xiàn)有害或侵權(quán)內(nèi)容，請(qǐng)點(diǎn)擊一鍵舉報(bào)。

轉(zhuǎn)藏 分享

QQ空間 QQ好友新浪微博微信

獻(xiàn)花（0） +1

來(lái)自：印度阿三17 > 《開發(fā)》

舉報(bào)/認(rèn)領(lǐng)