闪验uniapp集成文档，DCloud插件原生插件，一键登录、号码认证、本机校验、免密登录、uniapp开发集成指南，新一代快捷登录方案

大家好，欢迎来到IT知识分享网。

注：「插件市场地址」

创建应用

应用的创建流程及APPID的获取，请查看「账号创建」文档

注意：如果应用有多个包名或签名不同的马甲包，须创建多个对应包名和签名的应用，否则马甲包将报包名或签名校验不通过。

引用方式

const shanYanSDKModule = uni.requireNativePlugin('CLSDK-ShanYanSDKModule')

Android部分

一、免密登录API使用说明

1.初始化

调用SDK其他流程方法前，请确保已调用过初始化，否则会返回未初始化。（会采集信息，建议放到同意协议后调用）

调用示例

shanYanSDKModule.init({ appid: "您的创建应用时生成的appid", }, result => { //初始化回调 this.shanyan_code = JSON.stringify(result.code); this.shanyan_result = JSON.stringify(result.result); });

参数描述

返回参数含义如下：

2.预取号

• 【可选方法】获取取号临时凭证；建议在调用拉起授权页前2~3秒调用，可以缩短拉起授权页耗时；如果启动app就需要展示授权页，中间没有2~3秒的间隔，不建议调用，起不到缩短时间的效果。
• 请勿与拉起授权登录页同时或之后调用。
• 避免大量资源下载时调用，例如游戏中加载资源或者更新补丁的时

调用示例：

 shanYanSDKModule.getPhoneInfo((result) => { //预取号回调 this.shanyan_code = JSON.stringify(result.code); this.shanyan_result = JSON.stringify(result.result); });

返回参数含义如下：

3.拉起授权页&获取token

• 拉起授权页方法将会调起运营商授权页面。已登录状态请勿调用 。
• 每次调用拉起授权页方法前均需先调用授权页配置方法，否则授权页可能会展示异常。
• 必须保证上一次拉起的授权页已经销毁再调用，否则SDK会返回请求频繁。
• 拉起一次授权页，登录按钮最多只能点击4次，第五次默认会置灰，不返回信息。

调用示例：

 shanYanSDKModule.openLoginAuth(isFinish, result => { //拉起授权页回调 this.shanyan_code = JSON.stringify(result.code); this.shanyan_result = JSON.stringify(result.result); }, result => { //点击登录按钮及返回键回调 this.shanyan_code = JSON.stringify(result.code); this.shanyan_result = JSON.stringify(result.result); });

参数描述

第一个回调返回参数含义如下：

第二个回调返回参数含义如下：

当第二个回调外层code为1000时，result的返回为

{ "token": "" }

含义如下：

4.置换手机号

当一键登录外层code为1000时，会获取到置换手机号所需的token。请参考「服务端」文档来实现获取手机号码的步骤

5.其他api

a.设置log开关

shanYanSDKModule.setDebug(true);

注：需要放到SDK初始化之前调用，用ProcessShanYanLogger可以过滤方法调用及回调等信息，用UIShanYanTask可以过滤UI配置相关日志，用ActivityLifecycleShanYanTask可以过滤界面生命周期相关日志。

b.设置loading显示状态

点登录按钮时默认会显示loading，本方法可在loading显示后改变loading状态时调用

shanYanSDKModule.setLoadingVisibility(true);

参数描述

c.设置协议勾选框状态

shanYanSDKModule.setCheckBoxValue(true);

参数描述

d.清理预取号缓存

shanYanSDKModule.clearScripCache();

e.获取运营商类型

 shanYanSDKModule.getOperatorType((result) => { //预取号回调 this.shanyan_code = JSON.stringify(result); });

返回值4种：CMCC、CUCC、CTCC、UNKNOWN_OPERATOR；

释义：CMCC（移动）；CUCC（联通）；CTCC（电信）； Unknown_Operator（无SIM卡或非三网运营商）

f.设置预取号超时时间

shanYanSDKModule.setTimeOutForPreLogin(5);

参数描述

注：不建议设置小于4的值，否则可能会导致超时的概率增加。

g.获取运营商信息

shanYanSDKModule.getOperatorInfo();

返回示例：

{"telecom":"CTCC", "protocolName":"天翼服务及隐私协议", "protocolUrl":"https:\/\/e.189.cn\/sdk\/agreement\/detail.do?hidetop=true"}

返回信息描述

h.协议点击事件监听

需要对协议点击事件监听的用户，可调用此方法监听协议点击事件，无此需求可以不写。

调用示例

shanYanSDKModule.setActionListener((result) => { //点击协议回调 this.shanyan_type = JSON.stringify(result.type); this.shanyan_code = JSON.stringify(result.code); this.shanyan_message = JSON.stringify(result.message); });

getOnClickPrivacyStatus(int code, String result,String operator)方法返回参数含义如下：

i.授权页点击事件监听

需要对授权页点击事件监听的用户，可调用此方法监听授权页点击事件，无此需求可以不写。

调用示例

shanYanSDKModule.setActionListener((result) => { //点击协议回调 this.shanyan_type = JSON.stringify(result.type); this.shanyan_code = JSON.stringify(result.code); this.shanyan_message = JSON.stringify(result.message); });

getOnClickPrivacyStatus(int code, String result,String operator)方法返回参数含义如下：

j.销毁授权页

A.自动销毁

1.在授权登录页面，当用户主动点击左左上角返回按钮时，返回码为1011，授权页面将自动销毁授权页；

2.当用户点击物理返回键返回键（相当于取消登录），返回码为1011，授权页面将自动销毁授权页

3.当用户设置一键登录或者其他自定义控件为自动销毁时，得到回调后，授权页面将自动销毁

B.手动销毁

调用示例

shanYanSDKModule.finishAuthActivity();

注意：销毁授权页时，请不要在销毁后回到的界面主线程中做耗时操作，避免堵塞授权页onDestroy方法，导致再次调用拉起授权页时报请求频繁。

6.授权页界面配置

a.设计规范

闪验登录授权界面设计规范

注意：开发者不得通过任何技术手段，将授权页面的登录按钮、隐私栏、号码栏内容隐藏、覆盖，对于接入闪验SDK并上线的应用，我方和运营商会对授权页面做审查，如果有出现未按要求设计授权页面，我方有权将应用的一键登录功能下线。

b.授权页配置

调用该方法可实现对三网运营商授权页面个性化设计，配置一次有效，每次调用拉起授权页方法前必须先调用该方法，否则授权界面会展示异常，具体实现可参考demo示例的ConfigUtils配置类。（三网界面配置内部实现逻辑不同，请务必使用移动、联通、电信卡分别测试）

调用示例：

shanYanSDKModule.setAuthThemeConfig({    //授权页已有元素配置    uiConfig: {        setAuthBGImgPath: "static/eb9a0dae18491990a43fe02832d3cafa.jpg",            setNavColor: '#ff0000',            setNavText: "",            setNavTextSize: "0",            setNavReturnImgPath: "static/close_black.png",            setNavReturnBtnOffsetRightX: "15",            setLogoImgPath: 'static/logo_shanyan_text.png',            setLogoOffsetY: "15",            setLogoWidth: "110",            setLogoHeight: "60",            setNumFieldOffsetY: "80",            setNumberSize: "18",            setLogBtnText: "本机号码免密登录",            setLogBtnOffsetY: "140",       		setLogBtnBackgroundColor:"#664455",            setPrivacyState: "true",            setAppPrivacyOne: {            title: '闪验用户协议',                url: "https://api.253.com/api_doc/yin-si-zheng-ce/wei-hu-wang-luo-an-quan-sheng-ming.html"                },        setAppPrivacyTwo: {            title: '闪验隐私政策',                url: "https://api.253.com/api_doc/yin-si-zheng-ce/ge-ren-xin-xi-bao-hu-sheng-ming.html"                },        setAppPrivacyThree: {            title: '服务协议',                url: "https://api.253.com/api_doc/yin-si-zheng-ce/ge-ren-xin-xi-bao-hu-sheng-ming.html"                },        setPrivacyText: {            privacyTextOne: '登录即同意',                privacyTextTwo: "、",                privacyTextThree: '、',                privacyTextFour: '和',                privacyTextFive: '并授权登录'                },        setSloganHidden: "true",            setDialogTheme: {            width: "300",                height: "400",                marginLeft: "0",                marginTop: "0",                isBottom: "false"                }    },     //授权页添加自定义控件元素    widgets: {        widget1: {            widgetId: "customView_one",                type: "TextView",                left: "",                top: "195",                right: "",                bottom: "",                width: "",                height: "30",                textContent: "自定义控件（不销毁授权页）",                textFont: "13",                textColor: "#cc0000",                backgroundColor: "#ffffff",                isFinish: "false"                },        widget2: {            widgetId: "customView_two",                type: "ImageView",                left: "",                top: "230",                right: "",                bottom: "",                width: "30",                height: "30",                backgroundImgPath: "static/.png",                isFinish: "true"                }    },}, //授权页添加自定义控件元素点击事件监听                    result => {    console.log(JSON.stringify(result));});

ShanYanUIConfig.java配置元素说明

授权页背景

 String setAuthBGImgPath; //普通图片

授权页状态栏

 bool setLightColor; //设置状态栏字体颜色是否为白色 String setStatusBarColor; //设置状态栏背景颜色 bool setStatusBarHidden; // 设置状态栏是否隐藏 bool setVirtualKeyTransparent; //设置虚拟键是否透明

授权页导航栏

 String setNavColor; //设置导航栏背景颜色 String setNavText; //设置导航栏标题文字 String setNavTextColor; //设置导航栏标题文字颜色 int setNavTextSize; //设置导航栏标题文字大小 String setNavReturnImgPath; //设置导航栏返回按钮图标 bool setNavReturnImgHidden = false; //设置导航栏返回按钮是否隐藏（true：隐藏；false：不隐藏） int setNavReturnBtnWidth; //设置导航栏返回按钮宽度 int setNavReturnBtnHeight; //设置导航栏返回按钮高度 int setNavReturnBtnOffsetRightX; //设置导航栏返回按钮距离屏幕右侧X偏移 int setNavReturnBtnOffsetX; //设置导航栏返回按钮距离屏幕左侧X偏移 int setNavReturnBtnOffsetY; //设置导航栏返回按钮距离屏幕上侧Y偏移 bool setAuthNavHidden; //设置导航栏是否隐藏（true：隐藏；false：不隐藏） bool setAuthNavTransparent; //设置导航栏是否透明（true：透明；false：不透明） bool setNavTextBold; // 设置导航栏字体是否加粗（true：加粗；false：不加粗）

授权页logo

 String setLogoImgPath; //设置logo图片 int setLogoWidth; //设置logo宽度 int setLogoHeight; //设置logo高度 int setLogoOffsetY; //设置logo相对于标题栏下边缘y偏移 int setLogoOffsetBottomY; //设置logo相对于屏幕底部y偏移 bool setLogoHidden; //设置logo是否隐藏（true：隐藏；false：不隐藏） int setLogoOffsetX; //设置logo相对屏幕左侧X偏移

授权页号码栏

 String setNumberColor; //设置号码栏字体颜色 int setNumFieldOffsetY; //设置号码栏相对于标题栏下边缘y偏移 int setNumFieldOffsetBottomY; //设置号码栏相对于屏幕底部y偏移 int setNumFieldWidth; //设置号码栏宽度 int setNumFieldHeight; //设置号码栏高度 int setNumberSize; //设置号码栏字体大小 int setNumFieldOffsetX; //设置号码栏相对屏幕左侧X偏移 bool setNumberBold; //设置号码栏字体是否加粗（true：加粗；false：不加粗） bool setTextSizeIsdp; //设置整个授权页字体单位是否是dp

授权页登录按钮

 String setLogBtnText; //设置登录按钮文字 String setLogBtnTextColor; //设置登录按钮文字颜色 String setLogBtnBackgroundColor; //设置登录按钮背景颜色 String setLogBtnImgPath; //设置授权登录按钮图片 int setLogBtnOffsetY; //设置登录按钮相对于标题栏下边缘Y偏移 int setLogBtnOffsetBottomY; //设置登录按钮相对于屏幕底部Y偏移 int setLogBtnTextSize; //设置登录按钮字体大小 int setLogBtnHeight; //设置登录按钮高度 int setLogBtnWidth; //设置登录按钮宽度 int setLogBtnOffsetX; //设置登录按钮相对屏幕左侧X偏移 bool setLogBtnTextBold //设置登录按钮字体是否加粗（true：加粗；false：不加粗）

授权页隐私栏

 List<String> setAppPrivacyOne; //设置开发者隐私条款1，包含两个参数：1.title：名称2.URL:链接 setAppPrivacyOne:{ title:'用户协议1', url:"http://flash.253.com/" }, List<String> setAppPrivacyTwo; //设置开发者隐私条款2，包含两个参数：1.title：名称2.URL:链接 setAppPrivacyTwo:{ title:'用户协议1', url:"http://flash.253.com/" }, List<String> setAppPrivacyThree; //设置开发者隐私条款3，包含两个参数：1.title：名称2.URL:链接 setAppPrivacyThree:{ title:'用户协议1', url:"http://flash.253.com/" }, bool setPrivacySmhHidden; //设置协议名称是否显示书名号《》，默认显示书名号（true：不显示；false：显示） int setPrivacyTextSize; //设置隐私栏字体大小 List<String> setAppPrivacyColor; //设置隐私条款文字颜色，包含两个参数：1.privacyBaseColor：基础文字颜色 2.privacyColor：协议文字颜色 setAppPrivacyColor:{ privacyBaseColor:'#ffffff', privacyColor:'#080808' }, int setPrivacyOffsetBottomY; //设置隐私条款相对于授权页面底部下边缘y偏移 int setPrivacyOffsetY; //设置隐私条款相对于授权页面标题栏下边缘y偏移 int setPrivacyOffsetX; //设置隐私条款相对屏幕左侧X偏移 list<int> setcheckBoxOffsetXY; //设置checkbox在协议框父控件中的位置，包含两个参数：1.x：x偏移量 2.y：y偏移量 setCheckBoxOffsetXY：{ x:'', y:'' }, bool setPrivacyTextBold; //设置协议栏字体是否加粗（true：加粗；false：不加粗） bool setPrivacyOffsetGravityLeft; //设置隐私条款文字左对齐（true：左对齐；false：居中） bool setPrivacyState; //设置隐私条款的CheckBox是否选中（true：选中；false：未选中） String setUncheckedImgPath; //设置隐私条款的CheckBox未选中时图片 String setCheckedImgPath; //设置隐私条款的CheckBox选中时图片 bool setCheckBoxHidden; //设置隐私条款的CheckBox是否隐藏（true：隐藏；false：不隐藏） List<int> setCheckBoxWH; //设置checkbox的宽高，包含两个参数：1.width：宽 2.height：高 setCheckBoxWH:{ width:'', height:'' }, List<int> setCheckBoxMargin; //设置checkbox的间距，包含四个参数：1.marginLeft：左间距 2.marginTop：上间距 3.marginRight：右间距 4.marginBottom：下间距 setCheckBoxMargin:{ marginLeft:'', marginTop:'', marginRight:'', marginBottom:'' }, List<String> setPrivacyText; //设置隐私条款名称外的文字,包含五个参数(privacyTextOne,privacyTextTwo,privacyTextThree,privacyTextFour,privacyTextFive) setPrivacyText:{ privacyTextOne:'同意', privacyTextTwo:"、", privacyTextThree:'', privacyTextFour:'', privacyTextFive:"并授权登录" }, String setPrivacyCustomToastText; //未勾选协议时toast提示文字 bool setPrivacyNameUnderline; //协议是否显示下划线（true：显示；false：不显示） bool setOperatorPrivacyAtLast; //运营商协议是否为最后一个显示（true：最后显示；false：不在最后显示） bool setPrivacyGravityHorizontalCenter; //设置隐私协议栏是否居中显示（true：居中；false：居左） 

授权页slogan

 String setSloganTextColor; //设置slogan文字颜色 int setSloganTextSize; //设置slogan文字字体大小 int setSloganOffsetY; //设置slogan相对于标题栏下边缘y偏移 bool setSloganHidden = false; //设置slogan是否隐藏（true：隐藏；false：不隐藏） int setSloganOffsetBottomY; //设置slogan相对屏幕底部Y偏移 int setSloganOffsetX; //设置slogan相对屏幕左侧X偏移

创蓝slogan

//创蓝slogan设置 int setShanYanSloganOffsetY; //设置创蓝slogan相对于标题栏下边缘y偏移 int setShanYanSloganOffsetBottomY; //设置创蓝slogan相对屏幕底部Y偏移 int setShanYanSloganOffsetX; //设置创蓝slogan相对屏幕左侧X偏移 String setShanYanSloganTextColor; //设置创蓝slogan文字颜色 int setShanYanSloganTextSize; //设置创蓝slogan文字字体大小 bool setShanYanSloganHidden; //设置创蓝slogan是否隐藏（true：隐藏；false：不隐藏） bool setShanYanSloganTextBold; //设置创蓝slogan文字字体是否加粗（true：加粗；false：不加粗）

协议页导航栏

 String setPrivacyNavColor; //设置协议页导航栏背景颜色 bool setPrivacyNavTextBold; //设置协议页导航栏标题文字是否加粗（true：加粗；false：不加粗） String setPrivacyNavTextColor; //设置协议页导航栏标题文字颜色 int setPrivacyNavTextSize; //设置协议页导航栏标题文字大小 String setPrivacyNavReturnImgPath; //设置协议页导航栏返回按钮图标 bool setPrivacyNavReturnImgHidden; //设置协议页导航栏返回按钮是否隐藏（true：隐藏；false：不隐藏） int setPrivacyNavReturnBtnWidth; //设置协议页导航栏返回按钮宽度 int setPrivacyNavReturnBtnHeight; //设置协议页导航栏返回按钮高度 int setPrivacyNavReturnBtnOffsetRightX; //设置协议页导航栏返回按钮距离屏幕右侧X偏移 int setPrivacyNavReturnBtnOffsetX; //设置协议页导航栏返回按钮距离屏幕左侧X偏移 int setPrivacyNavReturnBtnOffsetY; //设置协议页导航栏返回按钮距离屏幕上侧Y偏移

授权页弹窗样式

float setDialogDimAmount; //授权页遮盖层灰度设置范围是（0~1） List<String>setDialogTheme; //设置授权页为弹窗样式，包含5个参数：1.width：弹窗宽度 2.height:弹窗高度 3.marginLeft:弹窗X偏移量（以屏幕中心为原点） 4.marginTop:弹窗Y偏移量（以屏幕中心为原点） 5.isBottom:授权页弹窗是否贴于屏幕底部 setDialogTheme: { width: "300", height: "400", marginLeft: "0", marginTop: "0", isBottom: "false" }

自定义控件

 String widgetId; //自定义控件ID String type; //自定义控件类型，目前只支持 TextView,ImageView int left = 0; // 自定义控件距离屏幕左边缘偏移量，单位dp int top = 0; // 自定义控件距离导航栏底部偏移量，单位dp int right = 0; // 自定义控件距离屏幕右边缘偏移量，单位dp int bottom = 0; // 自定义控件距离屏幕底部偏移量，单位dp int width = 0; // 自定义控件宽度，单位dp int height = 0; // 自定义控件高度，单位dp String textContent = ""; // type为TextView时，自定义控件内容 double textFont = 13.0; // type为TextView时，自定义控件文字大小，单位sp String textColor = "#aa0000"; // type为TextView时，自定义控件文字颜色 String backgroundColor; // type为TextView时，自定义控件背景颜色 String backgroundImgPath; // type为ImageView时 自定义控件背景图片 bool isFinish = true; //点击自定义控件是否自动销毁授权页

注意：

a.控件X偏移如果不设置默认居中。

二、本机认证API使用说明

注：本机认证、免密登录可共用初始化，两个功能同时使用时，只需调用一次初始化即可。

1.初始化

同免密登录初始化

2.本机号校验

在初始化执行之后调用，本机号校验界面需自行实现，可以在多个需要校验的页面中调用。

调用示例：

 shanYanSDKModule.startAuthentication((result) => { uni.hideLoading(); this.shanyan_code = JSON.stringify(result.code); this.shanyan_result = JSON.stringify(result.result); });

返回参数含义如下：

当外层code为2000时，result的返回为

{ "token":"" }

含义如下：

3.校验手机号

当本机号校验外层code为2000时，您将获取到返回的参数，请将这些参数传递给后端开发人员，并参考「服务端」文档来实现校验本机号的步骤

iOS部分

前置条件

• 闪验SDK支持Xcode 9.4.1，iOS8.0+及以上版本。
• 闪验SDK支持中国移动、联通、电信4G的取号能力。
• 闪验SDK支持网络环境为

a.纯数据网络

b.数据网络与wifi网络双开

• 对于双卡手机，闪验SDK取当前流量卡号

一、免密登录API使用说明

1.初始化

/初始化*/ func init(option: callBack:)

参数描述

CLComplete:所有回调返回的统一形式，errorCode存在即失败，否则为成功

接口作用

初始化SDK :传入用户的appID、appKey,获取本机运营商,读取缓存,获取运营商配置,初始化SDK

使用场景

• 建议在app启动时调用 即App.vue的onLaunch事件中
• 必须在一键登录前至少调用一次
• 只需调用一次，多次调用不会多次初始化，与一次调用效果一致

请求示例代码

const shanYanSDKModule = uni.requireNativePlugin('CLSDK-ShanYanSDKModule'); //调用 export default { onLaunch: function() { //初始化 shanYanSDKModule.init({ 'appid' : 'eWWfA2KJ' //'appkey' : 'tDo3Ml2K',//2.3.0及以上版本无需传入appkey },result => { console.log(JSON.stringify(result)); }); console.log('App Launch'); }, }

2.预取号

/ * 预取号（获取临时凭证） * 建议在判断当前用户属于未登录状态时使用，已登录状态用户请不要调用该方法 */ func preGetPhonenumber(callBack:CLComplete);

接口作用

电信、联通、移动预取号 :初始化成功后，如果当前为电信/联通/移动，将调用预取号，可以提前获知当前用户的手机网络环境是否符合一键登录的使用条件，成功后将得到用于一键登录使用的临时凭证，默认的凭证有效期60min。

使用场景

• 建议在执行一键登录的方法前，提前一段时间调用此方法，比如调一键登录的vc的onLoad中，或者rootVC的rootVC中，或者app启动后，此调用将有助于提高闪验拉起授权页的速度和成功率
• 不建议调用后立即调用拉起授权页方法（此方法是异步）
• 此方法需要1~2s的时间取得临时凭证，因此也不建议和拉起授权页方法一起串行调用
• 不建议频繁的多次调用和在拉起授权页后调用
• 建议在判断当前用户属于未登录状态时使用，已登录状态用户请不要调用该方法

请求示例代码

 import service from '../../service.js'; import { mapState, mapMutations } from 'vuex' import mInput from '../../components/m-input.vue' const shanYanSDKModule = uni.requireNativePlugin('CLSDK-ShanYanSDKModule'); //调用 export default { onLoad: function (option) { //预取号 shanYanSDKModule.preGetPhonenumber((complete) => { console.log(JSON.stringify(complete)); }); },

3.拉起授权页

//闪验一键登录接口 shanYanSDKModule.quickAuthLoginWithConfigure(clUIConfigure:openLoginAuthListener:oneKeyLoginListener:);

参数描述

使用场景

• 用户进行一键登录操作时，调用一键登录方法，如果初始化成功，SDK将会拉起授权页面，用户授权后，SDK将返回取号 token给到应用客户端。
• 可以在多处调用
• 需在调用预初始化方法之后调用

一键登录逻辑说明

• 存在调用预初始化时获取的临时凭证，调用一键登录方法将立即拉起授权页面
• openLoginAuthListener 拉起授权页监听回调，拉起成功或失败均触发
• 不存在临时凭证或临时凭证过期时(临时凭证有效期电信10min、联通30min、移动60min)，调用一键登录方法，将有一个很短的时延，待取号成功后拉起授权页面
• 取号失败时，返回失败

请求示例代码

 uni.showLoading({ mask: true, }) setTimeout(function () { uni.hideLoading(); }, 5000); //配置界面 //iOS 全屏模式 let screenWidth_Portrait = plus.screen.resolutionWidth; //竖屏宽 let screenHeight_Portrait = plus.screen.resolutionHeight; //竖屏宽 let screenWidth_Landscape = plus.screen.resolutionHeight; //横屏宽(即竖屏高) let screenHeight_Landscape = plus.screen.resolutionWidth; //横屏高(即竖屏宽) var screenScale = screenWidth_Portrait / 375.0; //相对iphone6屏幕 if (screenScale > 1) { screenScale = 1; //大屏的无需放大 } //竖屏 let clLayoutLogoTop_Portrait = screenScale * 60; let clLayoutLogoWidth_Portrait = 60 * screenScale; let clLayoutLogoHeight_Portrait = 60 * screenScale; let clLayoutLogoCenterX_Portrait = 0; let clLayoutPhoneCenterY_Portrait = -20 * screenScale; let clLayoutPhoneLeft_Portrait = 50 * screenScale; let clLayoutPhoneRight_Portrait = -50 * screenScale; let clLayoutPhoneHeight_Portrait = 20 * screenScale; let clLayoutLoginBtnCenterY_Portrait = clLayoutPhoneCenterY_Portrait + clLayoutPhoneHeight_Portrait * 0.5 * screenScale + 20 * screenScale + 15 * screenScale; let clLayoutLoginBtnHeight_Portrait = 30 * screenScale; let clLayoutLoginBtnLeft_Portrait = 70 * screenScale; let clLayoutLoginBtnRight_Portrait = -70 * screenScale; let clLayoutAppPrivacyLeft_Portrait = 40 * screenScale; let clLayoutAppPrivacyRight_Portrait = -40 * screenScale; let clLayoutAppPrivacyBottom_Portrait = 0 * screenScale; let clLayoutAppPrivacyHeight_Portrait = 45 * screenScale; let clLayoutSloganLeft_Portrait = 0; let clLayoutSloganRight_Portrait = 0; let clLayoutSloganHeight_Portrait = 15 * screenScale; let clLayoutSloganBottom_Portrait = clLayoutAppPrivacyBottom_Portrait - clLayoutAppPrivacyHeight_Portrait; shanYanSDKModule.quickAuthLoginWithConfigure(this.ios_uiConfigure, openLoginAuthListenerResult => { //拉起授权页面回调:调起授权页面成功/失败 uni.hideLoading(); //debug_test uni.showToast({ icon: "none", title: JSON.stringify(openLoginAuthListenerResult), duration: 3000 }); }, oneKeyLoginListenerResult => { uni.hideLoading(); //点一键登录回调 if (oneKeyLoginListenerResult.errorCode != null){ if(oneKeyLoginListenerResult.code == 1011){ //提示：错误无需提示给用户，可以在用户无感知的状态下直接切换登录方式 //用户取消登录（点返回） //处理建议：如无特殊需求可不做处理，仅作为交互状态回调，此时已经回到当前用户自己的页面 //点击sdk自带的返回，无论是否设置手动销毁，授权页面都会强制关闭 }else{ //处理建议：其他错误代码表示闪验通道无法继续，可以统一走开发者自己的其他登录方式，也可以对不同的错误单独处理 //1003 一键登录获取token失败 //其他 其他错误// //关闭授权页 shanYanSDKModule.finishAuthControllerCompletion(oneKeyLoginListenerResult => { }); } }else{ //SDK获取Token成功 //此处根据token调用户后台接口获取手机号，获取成功或失败后再调shanYanSDKModule.finishAuthControllerCompletion()关闭页面 // //关闭授权页 shanYanSDKModule.finishAuthControllerCompletion(oneKeyLoginListenerResult => { }); //debug_test uni.showToast({ icon: "none", title: JSON.stringify(oneKeyLoginListenerResult), duration: 3000 }); } }); }

一键登录 oneKeyLoginListenerResult:正确返回示例

{ "message":"获取联通token成功", "data": { "token":"A2-7NA_jWQuN0XsJsZQOY8BtvdKtrhNK9QStebzzyzgh7ElebpB8xGy3rapp4yyxX8-VEVgMhiB3wO4P0PnCZNjtPAZO9KfeODdYxhgn5Qn8vnxOvgk4_Ov_39d56-v1p87-IcFHKlji4nhvCd1VmrxOSHx6KB6i6lZqFYqGgcbKfpG-yaGL6pcY4T9mbrtsOpbUhrdamE7eA1KaruyOdkL1SThGJZt_-8imf91EyrXckg=" }, "code":1000 }

4.销毁授权页

A.授权页面自动销毁

1.在授权登录页面，当用户主动点击左左上角返回按钮时，返回码为1011，SDK将自动销毁授权页；

2.当用户设置一键登录或者其他自定义控件为自动销毁时，得到回调后，授权页面会自动销毁

B.授权页手动销毁

1.当设置一键登录为手动销毁时，点击授权页一键登录按钮成功获取token不会自动销毁授权页，请务必在回调中处理完自己的逻辑后手动调用销毁授权页方法。

2.当设置自定义控件为手动销毁时，请务必在回调中处理完自己的逻辑后手动调用销毁授权页方法。

调用示例

shanYanSDKModule.finishAuthControllerCompletion();

5.置换手机号

当一键登录oneKeyLoginListenerResult 回调errorCode为null时，您将获取到返回的参数，请将这些参数传递给后端开发人员，并参考「服务端」文档来实现获取手机号码的步骤。

6.授权页界面配置

调用该方法可实现对三网运营商授权页面个性化设计。（三网界面配置内部实现逻辑不同，请务必使用移动、联通、电信卡分别测试三网界面）

调用示例

简单竖屏全屏模式

//iOS 简单竖屏全屏模式 let screenWidth_Portrait = plus.screen.resolutionWidth; //竖屏宽 var screenScale = screenWidth_Portrait / 375.0; //相对iphone6屏幕 if (screenScale > 1) { screenScale = 1; //大屏的无需放大 } //先计算各控件位置及相对关系 //logo let clLayoutLogoTop_Portrait = screenScale * 60; let clLayoutLogoWidth_Portrait = 60 * screenScale; let clLayoutLogoHeight_Portrait = 60 * screenScale; let clLayoutLogoCenterX_Portrait = 0; //手机号 let clLayoutPhoneCenterY_Portrait = -20 * screenScale; let clLayoutPhoneLeft_Portrait = 50 * screenScale; let clLayoutPhoneRight_Portrait = -50 * screenScale; let clLayoutPhoneHeight_Portrait = 20 * screenScale; //一键登录按钮 let clLayoutLoginBtnCenterY_Portrait = clLayoutPhoneCenterY_Portrait + clLayoutPhoneHeight_Portrait * 0.5 * screenScale + 20 * screenScale + 15 * screenScale; let clLayoutLoginBtnHeight_Portrait = 30 * screenScale; let clLayoutLoginBtnLeft_Portrait = 70 * screenScale; let clLayoutLoginBtnRight_Portrait = -70 * screenScale; //隐私协议 let clLayoutAppPrivacyLeft_Portrait = 40 * screenScale; let clLayoutAppPrivacyRight_Portrait = -40 * screenScale; let clLayoutAppPrivacyBottom_Portrait = 0 * screenScale; let clLayoutAppPrivacyHeight_Portrait = 45 * screenScale; //运营商能力标签(认证服务由提供) let clLayoutSloganLeft_Portrait = 0; let clLayoutSloganRight_Portrait = 0; let clLayoutSloganHeight_Portrait = 15 * screenScale; let clLayoutSloganBottom_Portrait = clLayoutAppPrivacyBottom_Portrait - clLayoutAppPrivacyHeight_Portrait; //ios_uiConfigure 用于传入一键登录方法 this.ios_uiConfigure = { clBackgroundImg: "static/img/eb9a0daea43fe02832d3cafa.jpg",//全屏背景 shouldAutorotate: false,//支持自动旋转 /支持方向 * 如支持横竖屏，需同时设置 clOrientationLayOutPortrait 和 clOrientationLayOutLandscape * 0:UIInterfaceOrientationMaskPortrait//竖屏 * 1:UIInterfaceOrientationMaskLandscapeLeft//横屏左 * 2:UIInterfaceOrientationMaskLandscapeRight//横屏右 * 3:UIInterfaceOrientationMaskPortraitUpsideDown//上下倒置 * 4:UIInterfaceOrientationMaskLandscape//横屏左&右 * 5:UIInterfaceOrientationMaskAll//全部 * 6:UIInterfaceOrientationMaskAllButUpsideDown//全部但不包括上下倒置 * */ supportedInterfaceOrientations: 5, /偏好方向 * -1:UIInterfaceOrientationUnknown * 0:UIInterfaceOrientationPortrait * 1:UIInterfaceOrientationPortraitUpsideDown * 2:UIInterfaceOrientationLandscapeLeft * 3:UIInterfaceOrientationLandscapeRight * */ //偏好方向默认Portrait preferredInterfaceOrientationForPresentation: Number(5), clNavigationBackgroundClear: true,//导航栏透明 clNavigationBackBtnImage: "static/img/close-white.png",//返回按钮图片，自带返回按钮大小将由1x图片大小决定 clNavBackBtnAlimentRight: true,//返回按钮居右 clLogoImage: "static/img/logo_shanyan_text.png",//logo图片 clLoginBtnText: "本机号一键登录",//一键登录按钮文字 clLoginBtnTextColor: [1,1,1,1.0],//rgba clLoginBtnBgColor: [0.2,0.8,0.2,1.0],//rgba clLoginBtnTextFont: 15*screenScale, clLoginBtnCornerRadius: 10, clLoginBtnBorderWidth: 0.5, clLoginBtnBorderColor: [0.1,0.8,0.1,1.0],//rgba clPhoneNumberFont: 20.0*screenScale,//手机号字体 clAuthTypeUseWindow: false,//弹窗模式 //clAuthWindowCornerRadius: 20,//弹窗模式下的窗口圆角 //隐私协议 clAppPrivacyColor: [[0.6,0.6,0.6,1.0],[0,1,0,1.0]],//2 item,commomTextColor and appPrivacyTextColor clAppPrivacyTextFont: 11*screenScale, clAppPrivacyTextAlignment: 0,//0: center 1: left 2: right clAppPrivacyFirst: ["测试连接A","https://www.baidu.com"],// 2 item, name and url clAppPrivacySecond: ["测试连接B","https://www.sina.com"],// 2 item, name and url //隐私协议勾选框 clCheckBoxVerticalAlignmentToAppPrivacyCenterY: true, clCheckBoxSize: [30*screenScale,30*screenScale],//2 item, width and height clCheckBoxImageEdgeInsets: [2*screenScale,10*screenScale,13*screenScale,5*screenScale],//4 item, top left bottom right clCheckBoxUncheckedImage: "static/img/checkBoxNor.png", clCheckBoxCheckedImage: "static/img/checkBoxSEL.png", //加载动画 clLoadingSize : [50, 50],//2 item, width and height clLoadingTintColor : [0.2,0.8,0.2,1], clLoadingBackgroundColor : [1,1,1,1], clLoadingCornerRadius : 5, //竖屏布局对象 clOrientationLayOutPortrait:{ //控件: //logo clLayoutLogoWidth : clLayoutLogoWidth_Portrait, clLayoutLogoHeight : clLayoutLogoHeight_Portrait, clLayoutLogoCenterX : clLayoutLogoCenterX_Portrait, clLayoutLogoTop : clLayoutLogoTop_Portrait, //手机号 clLayoutPhoneCenterY : clLayoutPhoneCenterY_Portrait, clLayoutPhoneHeight : clLayoutPhoneHeight_Portrait, clLayoutPhoneLeft : clLayoutPhoneLeft_Portrait, clLayoutPhoneRight : clLayoutPhoneRight_Portrait, //一键登录按钮 clLayoutLoginBtnCenterY : clLayoutLoginBtnCenterY_Portrait, clLayoutLoginBtnHeight : clLayoutLoginBtnHeight_Portrait, clLayoutLoginBtnLeft : clLayoutLoginBtnLeft_Portrait, clLayoutLoginBtnRight : clLayoutLoginBtnRight_Portrait, //隐私协议 clLayoutAppPrivacyLeft : clLayoutAppPrivacyLeft_Portrait, clLayoutAppPrivacyRight : clLayoutAppPrivacyRight_Portrait, clLayoutAppPrivacyBottom : clLayoutAppPrivacyBottom_Portrait, clLayoutAppPrivacyHeight : clLayoutAppPrivacyHeight_Portrait, //运营商能力标签(认证服务由提供) clLayoutSloganLeft : clLayoutSloganLeft_Portrait, clLayoutSloganRight : clLayoutSloganRight_Portrait, clLayoutSloganHeight : clLayoutSloganHeight_Portrait, clLayoutSloganBottom : clLayoutSloganBottom_Portrait, }, }

横竖屏+弹窗+自动旋转模式

 //iOS 弹窗模式 let screenWidth_Portrait = plus.screen.resolutionWidth; //竖屏宽 let screenHeight_Portrait = plus.screen.resolutionHeight; //竖屏宽 let screenWidth_Landscape = plus.screen.resolutionHeight; //横屏宽(即竖屏高) let screenHeight_Landscape = plus.screen.resolutionWidth; //横屏高(即竖屏宽) var screenScale = screenWidth_Portrait / 375.0; //相对iphone6屏幕 if (screenScale > 1) { screenScale = 1; //大屏的无需放大 } //竖屏 //窗口中心 let clAuthWindowOrientationCenterX_Portrait = screenWidth_Portrait * 0.5; let clAuthWindowOrientationCenterY_Portrait = screenHeight_Portrait * 0.5; //窗口宽高 let clAuthWindowOrientationWidth_Portrait = screenWidth_Portrait * 0.8; let clAuthWindowOrientationHeight_Portrait = clAuthWindowOrientationWidth_Portrait * 0.8; let clLayoutLogoTop_Portrait = screenScale * 25; let clLayoutLogoWidth_Portrait = 60 * screenScale; let clLayoutLogoHeight_Portrait = 60 * screenScale; let clLayoutLogoCenterX_Portrait = 0; let clLayoutPhoneCenterY_Portrait = -20 * screenScale; let clLayoutPhoneLeft_Portrait = 50 * screenScale; let clLayoutPhoneRight_Portrait = -50 * screenScale; let clLayoutPhoneHeight_Portrait = 20 * screenScale; let clLayoutLoginBtnCenterY_Portrait = clLayoutPhoneCenterY_Portrait + clLayoutPhoneHeight_Portrait * 0.5 * screenScale + 20 * screenScale + 15 * screenScale; let clLayoutLoginBtnHeight_Portrait = 30 * screenScale; let clLayoutLoginBtnLeft_Portrait = 70 * screenScale; let clLayoutLoginBtnRight_Portrait = -70 * screenScale; let clLayoutAppPrivacyLeft_Portrait = 40 * screenScale; let clLayoutAppPrivacyRight_Portrait = -40 * screenScale; let clLayoutAppPrivacyBottom_Portrait = 0 * screenScale; let clLayoutAppPrivacyHeight_Portrait = 45 * screenScale; let clLayoutSloganLeft_Portrait = 0; let clLayoutSloganRight_Portrait = 0; let clLayoutSloganHeight_Portrait = 15 * screenScale; let clLayoutSloganBottom_Portrait = clLayoutAppPrivacyBottom_Portrait - clLayoutAppPrivacyHeight_Portrait; //横屏 //窗口中心 let clAuthWindowOrientationCenterX_Landscape = screenWidth_Landscape * 0.5; let clAuthWindowOrientationCenterY_Landscape = screenHeight_Landscape * 0.5; //窗口宽高 let clAuthWindowOrientationWidth_Landscape = screenWidth_Portrait * 0.8; //窗口宽度为竖屏宽度的0.8; let clAuthWindowOrientationHeight_Landscape = clAuthWindowOrientationWidth_Landscape * 0.8; //窗口高度为窗口宽度的0.8 let clLayoutLogoWidth_Landscape = 60 * screenScale; let clLayoutLogoHeight_Landscape = 60 * screenScale; let clLayoutLogoCenterX_Landscape = 0; let clLayoutLogoTop_Landscape = 25 * screenScale; let clLayoutPhoneCenterY_Landscape = -20 * screenScale; let clLayoutPhoneLeft_Landscape = 50 * screenScale; let clLayoutPhoneRight_Landscape = -50 * screenScale; let clLayoutPhoneHeight_Landscape = 20 * screenScale; let clLayoutLoginBtnCenterY_Landscape = clLayoutPhoneCenterY_Landscape + clLayoutPhoneHeight_Landscape * 0.5 * screenScale + 20 * screenScale + 15 * screenScale; let clLayoutLoginBtnHeight_Landscape = 30 * screenScale; let clLayoutLoginBtnLeft_Landscape = 70 * screenScale; let clLayoutLoginBtnRight_Landscape = -70 * screenScale; let clLayoutAppPrivacyLeft_Landscape = 40 * screenScale; let clLayoutAppPrivacyRight_Landscape = -40 * screenScale; let clLayoutAppPrivacyBottom_Landscape = 0 * screenScale; let clLayoutAppPrivacyHeight_Landscape = 45 * screenScale; let clLayoutSloganLeft_Landscape = 0; let clLayoutSloganRight_Landscape = 0; let clLayoutSloganHeight_Landscape = 15 * screenScale; let clLayoutSloganBottom_Landscape = clLayoutAppPrivacyBottom_Landscape - clLayoutAppPrivacyHeight_Landscape; this.ios_uiConfigure = { clBackgroundImg: "static/eb9a0daea43fe02832d3cafa.jpg", shouldAutorotate: true, /支持方向 * 如支持横竖屏，需同时设置 clOrientationLayOutPortrait 和 clOrientationLayOutLandscape * 0:UIInterfaceOrientationMaskPortrait * 1:UIInterfaceOrientationMaskLandscapeLeft * 2:UIInterfaceOrientationMaskLandscapeRight * 3:UIInterfaceOrientationMaskPortraitUpsideDown * 4:UIInterfaceOrientationMaskLandscape * 5:UIInterfaceOrientationMaskAll * 6:UIInterfaceOrientationMaskAllButUpsideDown * */ supportedInterfaceOrientations: 5, /偏好方向 * -1:UIInterfaceOrientationUnknown * 0:UIInterfaceOrientationPortrait * 1:UIInterfaceOrientationPortraitUpsideDown * 2:UIInterfaceOrientationLandscapeLeft * 3:UIInterfaceOrientationLandscapeRight * */ //偏好方向默认Portrait preferredInterfaceOrientationForPresentation: Number(5), clNavigationBackgroundClear: true, //导航栏透明 clNavigationBackBtnImage: "static/img/close-white.png", //返回按钮图片 clNavBackBtnAlimentRight: true, //返回按钮居右 clLogoImage: "static/img/logo_shanyan_text.png", //logo图片 clLoginBtnText: "本机号一键登录", //一键登录按钮文字 clLoginBtnTextColor: [1, 1, 1, 1.0], //rgba clLoginBtnBgColor: [0.2, 0.8, 0.2, 1.0], //rgba clLoginBtnTextFont: 15 * screenScale, clLoginBtnCornerRadius: 10, clLoginBtnBorderWidth: 0.5, clLoginBtnBorderColor: [0.1, 0.8, 0.1, 1.0], //rgba clPhoneNumberFont: 20.0 * screenScale, clAuthTypeUseWindow: true, clAuthWindowCornerRadius: 20, clAppPrivacyColor: [ [0.6, 0.6, 0.6, 1.0], [0, 1, 0, 1.0] ], //2 item,commomTextColor and appPrivacyTextColor clAppPrivacyTextFont: 11 * screenScale, clAppPrivacyTextAlignment: 0, //0: center 1: left 2: right clAppPrivacyFirst: ["测试连接A", "https://www.baidu.com"], // 2 item, name and url clAppPrivacySecond: ["测试连接B", "https://www.sina.com"], // 2 item, name and url clCheckBoxVerticalAlignmentToAppPrivacyCenterY: true, clCheckBoxSize: [30 * screenScale, 30 * screenScale], //2 item, width and height clCheckBoxImageEdgeInsets: [2 * screenScale, 10 * screenScale, 13 * screenScale, 5 * screenScale], //4 item, top left bottom right clCheckBoxUncheckedImage: "static/img/checkBoxNor.png", clCheckBoxCheckedImage: "static/img/checkBoxSEL.png", clLoadingSize: [50, 50], //2 item, width and height clLoadingTintColor: [0.2, 0.8, 0.2, 1], clLoadingBackgroundColor: [1, 1, 1, 1], clLoadingCornerRadius: 5, //竖屏布局对象 clOrientationLayOutPortrait: { //窗口 clAuthWindowOrientationWidth: clAuthWindowOrientationWidth_Portrait, clAuthWindowOrientationHeight: clAuthWindowOrientationHeight_Portrait, clAuthWindowOrientationCenterX: clAuthWindowOrientationCenterX_Portrait, clAuthWindowOrientationCenterY: clAuthWindowOrientationCenterY_Portrait, //控件 clLayoutLogoWidth: clLayoutLogoWidth_Portrait, clLayoutLogoHeight: clLayoutLogoHeight_Portrait, clLayoutLogoCenterX: clLayoutLogoCenterX_Portrait, clLayoutLogoTop: clLayoutLogoTop_Portrait, clLayoutPhoneCenterY: clLayoutPhoneCenterY_Portrait, clLayoutPhoneHeight: clLayoutPhoneHeight_Portrait, clLayoutPhoneLeft: clLayoutPhoneLeft_Portrait, clLayoutPhoneRight: clLayoutPhoneRight_Portrait, clLayoutLoginBtnCenterY: clLayoutLoginBtnCenterY_Portrait, clLayoutLoginBtnHeight: clLayoutLoginBtnHeight_Portrait, clLayoutLoginBtnLeft: clLayoutLoginBtnLeft_Portrait, clLayoutLoginBtnRight: clLayoutLoginBtnRight_Portrait, clLayoutAppPrivacyLeft: clLayoutAppPrivacyLeft_Portrait, clLayoutAppPrivacyRight: clLayoutAppPrivacyRight_Portrait, clLayoutAppPrivacyBottom: clLayoutAppPrivacyBottom_Portrait, clLayoutAppPrivacyHeight: clLayoutAppPrivacyHeight_Portrait, clLayoutSloganLeft: clLayoutSloganLeft_Portrait, clLayoutSloganRight: clLayoutSloganRight_Portrait, clLayoutSloganHeight: clLayoutSloganHeight_Portrait, clLayoutSloganBottom: clLayoutSloganBottom_Portrait, }, //横屏布局对象 clOrientationLayOutLandscape: { //窗口 clAuthWindowOrientationWidth: clAuthWindowOrientationWidth_Landscape, clAuthWindowOrientationHeight: clAuthWindowOrientationHeight_Landscape, clAuthWindowOrientationCenterX: clAuthWindowOrientationCenterX_Landscape, clAuthWindowOrientationCenterY: clAuthWindowOrientationCenterY_Landscape, //控件 clLayoutLogoWidth: clLayoutLogoWidth_Landscape, clLayoutLogoHeight: clLayoutLogoHeight_Landscape, clLayoutLogoCenterX: clLayoutLogoCenterX_Landscape, clLayoutLogoTop: clLayoutLogoTop_Landscape, clLayoutPhoneCenterY: clLayoutPhoneCenterY_Landscape, clLayoutPhoneHeight: clLayoutPhoneHeight_Landscape, clLayoutPhoneLeft: clLayoutPhoneLeft_Landscape, clLayoutPhoneRight: clLayoutPhoneRight_Landscape, clLayoutLoginBtnCenterY: clLayoutLoginBtnCenterY_Landscape, clLayoutLoginBtnHeight: clLayoutLoginBtnHeight_Landscape, clLayoutLoginBtnLeft: clLayoutLoginBtnLeft_Landscape, clLayoutLoginBtnRight: clLayoutLoginBtnRight_Landscape, clLayoutAppPrivacyLeft: clLayoutAppPrivacyLeft_Landscape, clLayoutAppPrivacyRight: clLayoutAppPrivacyRight_Landscape, clLayoutAppPrivacyBottom: clLayoutAppPrivacyBottom_Landscape, clLayoutAppPrivacyHeight: clLayoutAppPrivacyHeight_Landscape, clLayoutSloganLeft: clLayoutSloganLeft_Landscape, clLayoutSloganRight: clLayoutSloganRight_Landscape, clLayoutSloganHeight: clLayoutSloganHeight_Landscape, clLayoutSloganBottom: clLayoutSloganBottom_Landscape, }, } 

注：授权页基本控件均支持上、下、左、右、宽、高、水平中心、竖直中心布局设置，布局通过布局对象设置

布局类：CLOrientationLayOut:

自定义控件

widgets：自定义控件允许自定义导航栏左侧和右侧按钮，将替换sdk自带的返回按钮。允许添加控件到授权页上。

调用示例

this.ios_uiConfigure = { clBackgroundImg: "static/a.jpg", clOrientationLayOutPortrait: { ... } //自定义控件 widgets: { widget0: { widgetId: "customView_nav_left", //字符标记 type: "Button", // 类型：Button：按钮，ImageView:图片 TextView:文本 navPosition: "navleft", //按钮位置 navleft:导航栏左侧 ，navright:导航栏右侧（不设置默认添加到授权页上）,当设置为导航栏控件时，仅宽高可设置，位置固定 textContent: "自定义左侧返回按钮",//文字 textFont: 11,//字体 textColor: [1,1,0,1],//文字颜色[r,g,b,a] // backgroundColor: [0,0,1,1],//控件背景色[r,g,b,a] image: "static/img/close-black.png", // cornerRadius: 10,//圆角，设置圆角时请设置masksToBounds:true // masksToBounds:true,//圆角相关 isFinish: true,//点击销毁授权页, // clLayoutLeft:12, // clLayoutTop:60, // clLayoutRight:-12, // clLayoutBottom:-80, clLayoutWidth:40, clLayoutHeight:40, // clLayoutCenterX:0, // clLayoutCenterY:0, }, widgetnavRight: { widgetId: "customView_nav_right", //字符标记 type: "Button", // 类型：Button：按钮，ImageView:图片 TextView:文本 navPosition: "navright", //按钮位置 navleft:导航栏左侧 ，navright:导航栏右侧（不设置默认添加到授权页上）,当设置为导航栏控件时，仅宽高可设置，位置固定 textContent: "自定义控件1（点击销毁授权页）",//文字 textFont: 13,//字体 textColor: [0,1,0,1],//文字颜色[r,g,b,a] backgroundColor: [0,0,1,1],//控件背景色[r,g,b,a] image: "static/img/checkbox-multiple-ma.png", cornerRadius: 10,//圆角，设置圆角时请设置masksToBounds:true masksToBounds:true,//圆角相关 isFinish: true,//点击销毁授权页, // clLayoutLeft:12, // clLayoutTop:60, // clLayoutRight:-12, // clLayoutBottom:-80, clLayoutWidth:60, clLayoutHeight:40, // clLayoutCenterX:0, // clLayoutCenterY:0, }, widget1: { widgetId: "customView_one", //字符标记 type: "Button", // 类型：Button：按钮，ImageView:图片 TextView:文本 textContent: "自定义控件1（点击销毁授权页）",//文字 textFont: 13,//字体 textColor: [0,1,0,1],//文字颜色[r,g,b,a] backgroundColor: [0,0,1,1],//控件背景色[r,g,b,a] image: "static/img/logo_shanyan_text.png", cornerRadius: 10,//圆角，设置圆角时请设置masksToBounds:true masksToBounds:true,//圆角相关 isFinish: true,//点击销毁授权页, // clLayoutLeft:12, // clLayoutTop:60, // clLayoutRight:-12, clLayoutBottom:-50, clLayoutWidth:180, clLayoutHeight:50, clLayoutCenterX:0, // clLayoutCenterY:0, }, widget2: { widgetId: "customView_two", //字符标记 type: "TextView", // 类型：Button：按钮，ImageView:图片 TextView:文本 textContent: "自定义控件文本自定义控件文本自定义控件文本自定义控件文本自定义控件文本自定义控件文本自定义控件文本",//文字 textFont: 10,//字体 textColor: [1,0.5,0.6,1],//文字颜色[r,g,b,a] backgroundColor: [0,1,0,1],//控件背景色[r,g,b,a] numberOfLines:0, //行数：默认单行， 0:无限，自动换行，其他：指定行数 textAlignment: 2, //0: center 1: left 2: right //仅TextView有效 clLayoutLeft:80, // clLayoutTop:60, clLayoutRight:-80, clLayoutBottom:-120, // clLayoutWidth:150, clLayoutHeight:60, // clLayoutCenterX:0, // // clLayoutCenterY:0, }, widget3: { widgetId: "customView_three_imageView", //字符标记 type: "ImageView", // 类型：Button：按钮，ImageView:图片 TextView:文本 image: "static/img/shanyanlogo1.png", backgroundColor: [0,1,0,1],//控件背景色[r,g,b,a] cornerRadius: 40,//圆角，设置圆角时请设置masksToBounds:true masksToBounds:true,//圆角相关 clLayoutLeft:80, clLayoutTop:160, clLayoutRight:-80, // clLayoutBottom:-280, // clLayoutWidth:150, clLayoutHeight:80, // clLayoutCenterX:0, // clLayoutCenterY:0, } } } //设置自定义控件点击回调，返回信息带有widgetId shanYanSDKModule.setCustomInterface((customInterface) => { this.shanyan_result = JSON.stringify(customInterface); console.log(JSON.stringify(customInterface)); }); 

7.其他API

a.统一事件监听

需要对协议点击事件监听的用户，可调用此方法监听协议点击事件，无此需求可以不写。(iOS，安卓返回内容不一致。需要分开处理)

调用示例

/// 统一事件监听方法 /// @param type 事件类型（1：隐私协议点击， 2：协议勾选框点击，3："一键登录"按钮点击） /// @param code 事件对应序号 type=1时：code：0,1,2,3（协议页序号），message：协议名|当前运营商类型 /// type=2时：code：0,1（0为未选中，1为选中） /// type=3时：code：0,1（0为协议勾选框未选中，1为选中） /// @param message 说明：type=1时：message：协议名_当前运营商类型 shanYanSDKModule.setActionListener((actionListener) => { console.log(JSON.stringify(actionListener)); }); 

b.禁止日志上报获取IP（默认允许）

shanYanSDKModule.forbiddenNonessentialIp(true);

c.清理预取号缓存

shanYanSDKModule.clearScripCache();

二、本机认证API使用说明

注：本机认证、免密登录可共用初始化，两个功能同时使用时，只需调用一次初始化即可。

1.初始化

同免密登录初始化

2.本机号校验

在初始化执行之后调用，本机号校验界面需自行实现，可以在多个需要校验的页面中调用。

调用示例：

shanYanSDKModule.startAuthentication((result) => { uni.hideLoading(); this.shanyan_code = JSON.stringify(result.code); this.shanyan_result = JSON.stringify(result.result); let platform = uni.getSystemInfoSync().platform; if (platform == 'android') { }else if (platform == 'ios') { if (result.errorCode != null) { //iOS errorCode存在即为失败 }else{ //成功，取出token } } });

返回参数含义如下：

当result.errorCode不为空时，返回为

{ "message":"本机号校验获取联通token成功", "data": { "token":"A2-7NA_jWQuN0XsJsZQOY8BtvdKtrhNK9QStebzzyzgh7ElebpB8xGy3rapp4yyxX8-VEVgMhiB3wO4P0PnCZNjtPAZO9KfeODdYxhgn5Qn8vnxOvgk4_Ov_39d56-v1p87-IcFHKlji4nhvCd1VmrxOSHx6KB6i6lZqFYqGgcbKfpG-yaGL6pcY4T9mbrtsOpbUhrdamE7eA1KaruyOdkL1SThGJZt_-8imf91EyrXckg=" }, "code":1000 }

含义如下：

3.校验手机号

当本机号校验获取到token时，请将token传递给后端开发人员，并参考「服务端」文档来实现校验本机号的步骤

返回码

请查看官方文档【返回码】