APP端定義一些Router協(xié)議,前端或者后端只需遵循這個協(xié)議即可調(diào)用原生的相關(guān)接口
# 一、跳轉(zhuǎn)頁面 (iOS&安卓通用)
## 1、路由規(guī)則
sktbloom://push?ID=1001 (無參)
sktbloom://push?ID=1001&key=value&key=value&… (有參)
sktbloom 代表url schemes 固定不變
push 代表需要跳轉(zhuǎn)頁面
ID 代表具體跳轉(zhuǎn)到哪個頁面
##### ID詳細說明:
|~ID|~對應(yīng)的頁面|~參數(shù) |~特殊說明|
|| 1100|| 首頁|| ||url = sktbloom://push?ID=1100||
|| 1200|| 社區(qū)|| ||url = sktbloom://push?ID=1200||
|| 1300|| 我的|| ||url = sktbloom://push?ID=1300||
|| 1001|| 登錄頁|||| url = sktbloom://push?ID=1001||
|| 1002|| 發(fā)帖頁||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類型 ||~關(guān)鍵字 ||~定義范圍 ||
|| 跳轉(zhuǎn)|| push || 1000~1999||
|| 待定|| 待定 || 2000~2999||
|| 待定|| 待定 || 3000~3999||
##### 其他用法:
在Safari輸入:sktbloom://push?ID=1004&postsId=913965717358092289,如果你安裝了bloom APP 那么也能打開app的帖子詳情頁面
<br/>
## 2、關(guān)于分享
例如:
分享帖子詳情頁 ,給到前端對應(yīng)的shareWebUrl即為:https://www.webloom.cn/bloom_h5/#/Landingpage?ID=1004&postsId=913965717358092289
前端使用sktbloom://push? 拼接 ID=1004&postsId=913965717358092289 即可
<br/>
## 3、關(guān)于推送
例如:
需要推送帖子詳情頁 ,推送給移動端的url即為:sktbloom://push?ID=1004&postsId=913965717358092289
<br/>
# 二、原生向H5注入的方法
- 用戶信息
- 支付
- 分享
- 導(dǎo)航欄
- 圖片瀏覽器
- 相機相冊
- 刷新
## 1、用戶信息
### getToken
> app端會返回cookie,cookie由token,userId,appVer,cType,deviceId,apiVer六個字段拼接而來
### getUserInfo
> 獲取用戶信息,app端會返回responseObject,responseObject為后端返回的json數(shù)據(jù)
## 2、支付
### popPay
> 調(diào)起支付面板
||~參數(shù)||~備注||
|| payType|| 支付類型:1002阿里,2002微信 ||
|| trigger|| 后端獲取到的三方SKD參數(shù)||
## 3、分享
### !!#ff0000 showShareButton !!
> H5頁面導(dǎo)航欄右邊顯示分享按鈕 ,H5在需要的頁面加載完成后調(diào)用showShareButton方法并傳參數(shù)即可,不調(diào)用默認該頁面不顯示分享按鈕, !!#ff0000 appV1.0.1版本之后廢棄,請使用 “ showShareButtonConfigShareInfo ”代替!!
<br/>
請求參數(shù)說明:
||~參數(shù)||~類型||~說明||~備注||
|| shareTitle|| json || 五種平臺的分享標題 || qq/wb/wx/wxf/qqf 五種平臺標題 ||
|| shareSubTitle|| String || 分享內(nèi)容/子標題|| ||
|| 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頁面導(dǎo)航欄右邊顯示分享按鈕 ,H5在需要的頁面加載完成后調(diào)用showShareButtonConfigShareInfo方法并傳參數(shù)即可,不調(diào)用默認該頁面不顯示分享按鈕,(顯示分享按鈕,并配置分享信息,appV1.0.1版本之后代替showShareButton方法)
<br/>
請求參數(shù)說明:
||~參數(shù)||~類型||~說明||~備注||
|| wx ||json|| 微信 || ||
|| wxf ||json|| 微信朋友圈|| ||
|| qq ||json|| qq|| ||
|| qqf ||json|| qq空間|| ||
|| wb ||json|| 微博|| ||
||~參數(shù) ||~類型 ||~說明 ||~備注 ||
|| shareTitle ||String|| 分享標題 || ||
|| shareSubTitle ||String|| 分享子標題/內(nèi)容|| ||
|| shareImageUrl ||String|| 分享圖片|| ||
|| shareWebUrl ||String|| 分享的web鏈接|| ||
|| shareVideoUrl ||String|| 分享的視頻網(wǎng)頁播放地址|| ||
|| shareType ||int|| 分享類型 1、純文字 2、圖(在微博中可以是圖 文 鏈接) 3、網(wǎng)頁 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、導(dǎo)航欄
### showNavigationBar
> 顯示導(dǎo)航欄,webView將從導(dǎo)航欄下面開始布局,默認顯示導(dǎo)航欄
### hiddenNavigationBar
> 隱藏導(dǎo)航欄,在網(wǎng)頁完全加載之后調(diào)用此方法,webView將從狀態(tài)欄下面開始布局
### setNavigationBarTitle
> 設(shè)置導(dǎo)航欄標題,在網(wǎng)頁完全加載之后調(diào)用此方法,如未設(shè)置,默認和前端的title一致
請求參數(shù)說明:
||~參數(shù)||~類型||~默認值||~必填||~說明||
|| title || string || ||是|| 導(dǎo)航欄標題 ||
## 5、圖片瀏覽器
### previewImage
> 在新頁面中全屏預(yù)覽圖片。預(yù)覽的過程中用戶可以進行保存圖片操作。
請求參數(shù)說明:
||~參數(shù)||~類型||~默認值||~必填||~說明||
|| urls ||Array.<string>|| ||是|| 需要預(yù)覽的圖片鏈接列表。 ||
|| index ||string|| ||是|| 需要預(yù)覽的圖片下標 ||
請求示例:
```
{
"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
> 從本地相冊選擇圖片或使用相機拍照。