# 八、其他接口對接
# 1. 運(yùn)營位控制接口
# 運(yùn)營位控制接口(updateWxpayfaceBannerState)
作用： 設(shè)置微信支付運(yùn)營圖片狀態(tài)，默認(rèn)展示運(yùn)營位浮窗，可修改為(可展示/不可展示/展示浮窗)三種狀態(tài)
使用規(guī)則：通過郵件形式聯(lián)系微信支付運(yùn)營同學(xué)下發(fā)測試實際效果。具體郵件模板如下：
郵件發(fā)送：v_yoyolv@tencent.com
主題格式：[運(yùn)營位控制接口][反饋方名稱]
【正文內(nèi)容包括如下】
反饋方名稱：商戶名稱或服務(wù)商名稱
設(shè)備SN序列號：XXXXXXXXXXXXXXXXXXXXX
顯示尺寸（分辨率）：XXXX
海報樣式：大屏或浮窗
支持版本： 1.24及以上
# 接口函數(shù)
//WxPayFace.getInstance().updateWxpayfaceBannerState(map,IWxPayfaceCallback);
public void updateWxpayfaceBannerState(final Map bean, final IWxPayFaceCallbackAIDL wxpayfaceCallBack)
# 接口參數(shù)
| 參數(shù) | 必填 | 類型 | 說明 |
|---|---|---|---|
| banner_state | 是 | int | 設(shè)置運(yùn)營位狀態(tài): 0:展示大運(yùn)營圖片 1:關(guān)閉所有運(yùn)營圖片 2:展示運(yùn)營位浮窗 |
# 接口調(diào)用說明：
updateWxpayfaceBannerState 0時，即展示運(yùn)營位大圖效果時：
當(dāng)切換其他頁面需關(guān)閉廣告頁運(yùn)營位大圖，調(diào)用updateWxpayfaceBannerState 1來進(jìn)行關(guān)閉；
當(dāng)回到廣告頁需展示運(yùn)營位大圖時，調(diào)用updateWxpayfaceBannerState 0進(jìn)行開啟；
*請注意接口調(diào)用的時機(jī)，否則跳轉(zhuǎn)頁面時運(yùn)營位將不會自動關(guān)閉updateWxpayfaceBannerState 2，即展示運(yùn)營小浮標(biāo)效果時：
接口的調(diào)用可根據(jù)實際需要進(jìn)行更改，需要關(guān)閉則調(diào)用updateWxpayfaceBannerState 1來進(jìn)行關(guān)閉；
也可繼續(xù)調(diào)用updateWxpayfaceBannerState 2進(jìn)行小浮標(biāo)展示；
當(dāng)需要展示大圖效果時，調(diào)用updateWxpayfaceBannerState 0來開啟即可。
# 接口返回
| 參數(shù) | 必填 | 類型 | 說明 |
|---|---|---|---|
| return_code | 是 | string | 錯誤碼。公共定義見 公共錯誤碼 |
| err_code | 否 | Integer | 可為空，二級錯誤碼，公共定義見 二級錯誤碼 |
| return_msg | 是 | string(128) | 對錯誤碼的描述 |
# 實踐指引
private void updateWxpayfaceBannerState() {
HashMap<String, Integer> map = new HashMap<String, Integer>();
map.put("banner_state", 0); // 設(shè)置運(yùn)營位狀態(tài) 0： 可展示運(yùn)營圖片 1： 不可展示運(yùn)營圖片 必填
WxPayFace.getInstance().updateWxpayfaceBannerState(map, new IWxPayfaceCallback() {
@Override
public void response(Map info) throws RemoteException {
if (info == null) {
new RuntimeException("調(diào)用返回為空").printStackTrace();
return;
}
String code = (String) info.get("return_code"); // 錯誤碼
Integer errcode = (Integer) info.get("err_code");//二級錯誤碼
String msg = (String) info.get("return_msg"); // 錯誤碼描述
if (code == null || !code.equals("SUCCESS")) {
new RuntimeException("調(diào)用返回非成功信息,return_msg:" + msg + " ").printStackTrace();
return ;
}
/*
在這里處理您自己的業(yè)務(wù)邏輯：
執(zhí)行到這里說明用戶已經(jīng)確認(rèn)支付結(jié)果且成功了，此時刷臉支付界面關(guān)閉，您可以在這里選擇跳轉(zhuǎn)到其它界面
*/
}
});
}
# 2. TTS語音播報開關(guān)
作用： 開啟或者關(guān)閉TTS語音播報
支持版本： 2.30及以上
# Map參數(shù)
key：key_tts_switch；
value為0表示TTS語音播報開關(guān)關(guān)閉，為1表示TTS語音開關(guān)開啟。
# IWxPayfaceCallback回調(diào)
接口回調(diào)，返回return_code和return_msg信息。
# 使用示例
Map<String, Object> dataMap = new HashMap<>();
dataMap.put(FacePayConstants.KEY_TTS_SWITCH, FacePayConstants.TTS_SWITCH_DISABLED);// 關(guān)閉TTS開關(guān)
// dataMap.put(FacePayConstants.KEY_TTS_SWITCH, FacePayConstants.TTS_SWITCH_ENABLED);開啟TTS開關(guān)
WxPayFace.getInstance().ttsSwitch(dataMap, new IWxPayfaceCallback() {
@Override
public void response(Map info) throws RemoteException {
Log.i(TAG, "response: info=" + info);
}
});