# 八、其他接口对接

# 1. 运营位控制接口

# 运营位控制接口(updateWxpayfaceBannerState)

作用： 设置微信支付运营图片状态，默认展示运营位浮窗，可修改为(可展示/不可展示/展示浮窗)三种状态

使用规则：通过邮件形式联系微信支付运营同学下发测试实际效果。具体邮件模板如下：
邮件发送：v_yoyolv@tencent.com
主题格式：[运营位控制接口][反馈方名称]
【正文内容包括如下】
反馈方名称：商户名称或服务商名称
设备SN序列号：XXXXXXXXXXXXXXXXXXXXX
显示尺寸（分辨率）：XXXX
海报样式：大屏或浮窗

支持版本： 1.24及以上

# 接口函数

//WxPayFace.getInstance().updateWxpayfaceBannerState(map,IWxPayfaceCallback);
public void updateWxpayfaceBannerState(final Map bean, final IWxPayFaceCallbackAIDL wxpayfaceCallBack)

# 接口参数

参数	必填	类型	说明
banner_state	是	int	设置运营位状态: 0:展示大运营图片 1:关闭所有运营图片 2:展示运营位浮窗

# 接口调用说明：

updateWxpayfaceBannerState 0时，即展示运营位大图效果时：
当切换其他页面需关闭广告页运营位大图，调用updateWxpayfaceBannerState 1来进行关闭；
当回到广告页需展示运营位大图时，调用updateWxpayfaceBannerState 0进行开启；
*请注意接口调用的时机，否则跳转页面时运营位将不会自动关闭
updateWxpayfaceBannerState 2，即展示运营小浮标效果时：
接口的调用可根据实际需要进行更改，需要关闭则调用updateWxpayfaceBannerState 1来进行关闭；
也可继续调用updateWxpayfaceBannerState 2进行小浮标展示；
当需要展示大图效果时，调用updateWxpayfaceBannerState 0来开启即可。

# 接口返回

参数	必填	类型	说明
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); // 设置运营位状态   0： 可展示运营图片   1： 不可展示运营图片 必填
        WxPayFace.getInstance().updateWxpayfaceBannerState(map, new IWxPayfaceCallback() {
            @Override
            public void response(Map info) throws RemoteException {
                if (info == null) {
                    new RuntimeException("调用返回为空").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("调用返回非成功信息,return_msg:" + msg + "   ").printStackTrace();
                    return ;
                }
                /*
                在这里处理您自己的业务逻辑：
                执行到这里说明用户已经确认支付结果且成功了，此时刷脸支付界面关闭，您可以在这里选择跳转到其它界面
                 */
            }
        });
    }

# 2. TTS语音播报开关

作用： 开启或者关闭TTS语音播报

支持版本： 2.30及以上

# Map参数

key：key_tts_switch；
value为0表示TTS语音播报开关关闭，为1表示TTS语音开关开启。

# IWxPayfaceCallback回调

接口回调，返回return_code和return_msg信息。

# 使用示例

Map<String, Object> dataMap = new HashMap<>();
dataMap.put(FacePayConstants.KEY_TTS_SWITCH, FacePayConstants.TTS_SWITCH_DISABLED);// 关闭TTS开关
// dataMap.put(FacePayConstants.KEY_TTS_SWITCH, FacePayConstants.TTS_SWITCH_ENABLED);开启TTS开关
WxPayFace.getInstance().ttsSwitch(dataMap, new IWxPayfaceCallback() {
              @Override
              public void response(Map info) throws RemoteException {
                  Log.i(TAG, "response: info=" + info);
              }
          });