AndroidReadme

Size: px

Start display at page:

Download "AndroidReadme"

摘毓东
5 years ago
Views:

1 魔蝎 SDK 集成流程 (Android Studio 版本 ) 开始集成 1. 导入 SDK 将 SDK 目录下的文件 moxie-client-x.y.z.aar 包放到您工程的 libs 文件夹下在 build.gradle 里里添加如下依赖 dependencies {... // 按照 sdk 目录下的具体版本修改 compile(name:'moxie-client-x.y.z', ext:'aar') 或使用gradle 直接引入, 当前版本 Download dependencies { // gradle >= 3.0 implementation 'com.moxie:moxie-client:x.y.z' // gradle < 3.0 compile 'com.moxie:moxie-client:x.y.z' 2. 配置 build.gradle 2.1 添加依赖在 build.gradle 里里添加如下依赖 dependencies {... // 按照 sdk 目录下的具体版本修改 compile(name:'moxie-client-x.x.x', ext:'aar') 2.2 增加 ndk 配置 // 支持以下版本架构, 按需添加 defaultconfig { ndk { abifilters "x86_64", "arm64-v8a", "armeabi-v7a", "x86" 2.3 使 jni 目录指向工程的 libs 目录 sourcesets { main{ jnilibs.srcdirs = ['libs'] 2.4 添加 repositories repositories { flatdir { dirs 'libs' 3. 添加混淆代码具体请参照 app 目录下的 proguard-rules.pro 文件 4. 配置工程

2 第一步 : 打开 AndroidManifest.xml 添加 Activity 和 Service 声明 : <activity android:name="com.moxie.client.mainactivity" android:windowsoftinputmode="adjustresize statealwayshidden" android:theme="@android:style/theme.translucent.notitlebar"> <activity android:name="com.moxie.client.accessible.accessiblecrawleractivity" android:theme="@style/theme.appcompat.light.noactionbar" android:screenorientation="portrait" android:launchmode="singletask"/> <service android:name="com.moxie.client.accessible.accessiblecrawlerservice" android:enabled="true" android:exported="true" android:label="@string/accessibility_name" android:accessibilityflags="flagreportviewids" android:permission="android.permission.bind_accessibility_service"> <intent-filter> <action android:name="android.accessibilityservice.accessibilityservice" /> </intent-filter> <meta-data android:name="android.accessibilityservice" android:resource="@xml/accessible_crawler_config" /> </service> 注意 : 替换 ; 替换 ; 第二步 : 添加权限 : <uses-permission android:name="android.permission.internet" /> <uses-permission android:name="android.permission.access_network_state"/> <uses-permission android:name="android.permission.read_phone_state"/> <uses-permission android:name="android.permission.access_wifi_state"/> <uses-permission android:name="android.permission.access_fine_location"/> <uses-permission android:name="android.permission.access_coarse_location"/> <uses-permission android:name="android.permission.read_external_storage"/> <uses-permission android:name="android.permission.write_external_storage"/> 5. 打开 SDK 并接收回调第一步 : 在 Application.oncreate() 里里面调用 MoxieSDK.init(this); 完成初始化第二步 : 通过生成 MxParam 对象来完成各种参数的设置, 使用 MoxieSDK.getInstance().start() 方式开启, 示例例如下 : 具体的使用方法请参照 DEMO 里里的 BigDataFragment.java

3 // 合作方系统中的客户 ID String muserid = " 由用户自己定 "; // 合作方系统中的客户 ID // 获取任务状态时使用 ( 合作方申请接入后由魔蝎数据提供 ) String mapikey = " c09e1498ca9b1bcd534b5ad0c"; String mthemecolor= "#ff9500"; //SDK 里里页面主色调 MxParam mxparam = new MxParam(); mxparam.setuserid(muserid); mxparam.setapikey(mapikey); mxparam.settasktype(mxparam.param_task_mail); // 必传 // 必传 // 必传 mxparam.setphone(" "); mxparam.setname(" 张小明 "); mxparam.setidcard(" "); MoxieSDK.getInstance().start(getActivity(), mxparam, new MoxieCallBack() { public boolean callback(moxiecontext moxiecontext, MoxieCallBackData moxiecallbackdata) { return super.callback(moxiecontext, moxiecallbackdata); public void onerror(moxiecontext moxiecontext, MoxieException moxieexception) { super.onerror(moxiecontext, moxieexception); ); 通过 MxParam.setTaskType 传入不不同的值, 来打开不不同的功能, 目前魔蝎支持的功能如下 : java MxParam.PARAM_TASK_MAIL( 或 MxParam.PARAM_TASK_ ): 邮箱导入 MxParam.PARAM_TASK_ONLINEBANK: 网银导入 MxParam.PARAM_TASK_CARRIER: 运营商 - 接入完成 - - MxParam 支持的可配置项说明 1. 设置 SDK 里里页面主色调 mxparam.setthemecolor("#ff9500"); 2. 是否使用缓存默认账号会记住, 密码不不会记住如果设置 YES, 则不不会有任何缓存 mxparam.setcachedisable(mxparam.param_common_yes); 3. 设置导入过程中的自定义提示文案, 为居中显示 mxparam.setloadingviewtext(" 验证过程中不不会浪费您任何流量量 \n 请稍等片刻 "); 4. 自定义返回事件第一步 : mxparam.setquitdisable(true); 第二步 : 在 moxiecallback 里里面根据回调的当前状态处理理, 具体见 demo 的 BigFragment.java 类 5. 登录成功后可以提前退出 mxparam.setquitlogindone(mxparam.param_common_yes); 6. 自定义 Title, 还有更更多方法请用 IDE 查看

4 TitleParams titleparams = new TitleParams.Builder() // 设置返回键的 icon, 不不设置此方法会默认使用魔蝎的 icon.leftnormalimgresid(r.drawable.back) // 用于设置 selector, 表示按下的效果, 不不设置默认使 leftnormalimgresid() 设置的图片.leftPressedImgResId(R.drawable.back) // 标题字体颜色.titleColor(getContext().getResources().getColor(R.color.colorWhite)) //title 背景色.backgroundColor(getContext().getResources().getColor(R.color.colorAccent)) // 设置右边 icon.rightnormalimgresid(r.drawable.refresh) // 是否支持沉浸式.immersedEnable(true) //title 返回按钮旁边的文字 ( 关闭 ) 的颜色.leftTextColor(getContext().getResources().getColor(R.color.colorWhite)) //title 返回按钮旁边的文字, 一般为关闭.leftText( 关闭 ).build(); mxparam.settitleparams(titleparams); 7. 设置回调创建任务信息 mxparam.setcallbacktaskinfo(true); 8. 设置协议地址 mxparam.setagreementurl(" 9. 设置协议文字 mxparam.setagreemententrytext("xxx") 补充事项 1. 运营商自动预填账户密码 : 通过如下方式把用户姓名身份证手机号和密码传入, 打开 SDK 后我们会自动填上去使用方法如下 : MxLoginCustom logincustom = new MxLoginCustom(); Map<String, Object> loginparam = new HashMap<>(); loginparam.put("phone", " "); // 手机号 loginparam.put("name", " 普京大帝 "); // 姓名 loginparam.put("idcard", " "); // 身份证 // 是否允许用户修改以上信息 ( 目前仅支持运营商 ) // MxParam.PARAM_COMMON_NO: 不不允许用户在页面上修改身份证 / 手机号 / 姓名 / 密码 // MxParam.PARAM_COMMON_YES: 允许用户在页面上修改身份证 / 手机号 / 姓名 / 密码 logincustom.seteditable(mxparam.param_common_no); logincustom.setloginparams(loginparam); mxparam.setlogincustom(logincustom); 2. 网银登录的自定义 : 1. 支持直达指定银行行并预填充账户和密码 // 自定义参数 MxLoginCustom logincustom = new MxLoginCustom(); // 1. 信用卡 logincustom.setlogintype(mxlogincustom.login_type_v_creditcard); // 2. 直达指定的银行行 logincustom.setlogincode("cmb"); // 3. 通过传入 LoginParams 参数来指定登录账号 Map<String, Object> loginparams = new HashMap<>(); loginparams.put("username", "330681xxxxxxxxxx99"); loginparams.put("password", "123456"); // 参考网银的几种登录方式 logincustom.addloginparams(mxlogincustom.login_params_k_idcard, loginparams); mxparam.setlogincustom(logincustom); 2. 支持多账号填充选择

5 // 自定义参数 MxLoginCustom logincustom = new MxLoginCustom(); // 1. 信用卡 logincustom.setlogintype(mxlogincustom.login_type_v_creditcard); // 3. 直达指定的银行行 logincustom.setlogincode("cmb"); // 4. 指定身份证方式 Map<String, Object> logininfoidcard = new HashMap<>(); logininfoidcard.put("username", "330681xxxxxxxxxx99"); logininfoidcard.put("password", "123456"); // 设置为默认选中登录方式 logininfoidcard.put(mxlogincustom.login_params_k_selected, MxParam.PARAM_COMMON_YES); // 5. 指定账号密码方式 Map<String, Object> logininfousername = new HashMap<>(); logininfousername.put("username", "wangwu"); logininfousername.put("password", "121212"); // 6. 将以上的登录方式加入到 logincustom 中,key 值参考网银的几种登录方式 logincustom.addloginparams(mxlogincustom.login_params_k_idcard, logininfoidcard); logincustom.addloginparams("username", logininfousername); 注意 : 这里里的 USERNAME 为 login_type, 请通过调用魔蝎的 API( 和 ) 进行行确认 login_type 每家银行行不不一样, 总计有以下几种 : IDCARD, USERNAME, MOBILE( 以广发银行行为例例 ), CARDNO, CLIENTNO( 仅浦发银行行储蓄卡 ), CREDITCARDNO( 以招行行信用卡为例例 ), DEBITCARDNO( 以招行行储蓄卡为例例 ) 3. 网银直达指定银行行以下例例子为打开农业银行行信用卡页面 mxparam.settasktype(mxparam.param_task_onlinebank); mxparam.setlogincustom( new MxLoginCustom() // 信用卡.setLoginType(MxLoginCustom.LOGIN_TYPE_V_CREDITCARD) // 农业银行行.setLoginCode("ABC") ); 4. 网银直达指定卡片类型银行行列列表页面 1. 信用卡 mxparam.settasktype(mxparam.param_task_onlinebank); mxparam.setlogincustom( new MxLoginCustom().setLoginType(MxLoginCustom.LOGIN_TYPE_V_CREDITCARD) ); 2. 储蓄卡 mxparam.settasktype(mxparam.param_task_onlinebank); mxparam.setlogincustom( new MxLoginCustom().setLoginType(MxLoginCustom.LOGIN_TYPE_V_DEBITCARD) ); 5. 支持传入用户基本信息 mxparam.setphone(" "); mxparam.setname(" 陶 XX"); mxparam.setidcard(" xxxxxxxx99"); 6. 支持传入用户基本信息

6 Map<String, Object> loginparams = new HashMap<>(); loginparams.put("username", " @sohu.com"); loginparams.put("password", "123456"); // 独立密码, 目前仅支持 qq 邮箱 loginparams.put("sepwd", "123456"); mxparam.setlogincustom( new MxLoginCustom().setLoginCode("sohu.com").setLoginParams(loginParams) ); 1. 支持登录完成后直接退出 SDK mxparam.setquitlogindone(mxparam.param_common_yes); 2. 自定义返回事件 ( 物理理返回键和 actionbar 的返回按钮为同一个行行为 ) 具体代码参照 BigdataFragment.java java new MoxieCallBack() { public boolean callback(moxiecontext moxiecontext, MoxieCallBackData moxiecallbackdata) { // ret 3. 公积金金自动登录 MxLoginCustom logincustom = new MxLoginCustom(); Map<String, String> userparams = new HashMap<>(); // 这个 key 不不一定是 account, 有可能是其他值, 根据实际情况自己传入 userparams.put("account", " "); userparams.put("password", "moxie123456"); Map<String, Object> loginparams = new HashMap<>(); //key 为 1,2,3.. 分别表示登录的三种方式 : 客户号, 用户名, 市民邮箱.. loginparams.put("1", userparams); // 直达指定城市页面 logincustom.setlogincode("310000"); logincustom.setloginparams(loginparams); mxparam.setlogincustom(logincustom); 4. 自定义导入进度界面 1. 第一步 : 通过继承 android.app.fragment 并实现 StatusViewListener 接口的 void update Progress(JSONObject jsonobject) 方法来实现自定义的导入界面, 参考 Demo 里里的 ImportResultFragment.java 类 public class ImportResultFragment extends Fragment implements StatusViewListener { public void updateprogress(jsonobject jsonobject) { Log.e("ImportResultFragment", jsonobject.tostring()); // 返回进度状态信息账号 String percent = jsonobject.optstring("percent"); String message = jsonobject.optstring("message"); String account = jsonobject.optstring("account"); 2. 第二步 : 实现 StatusViewHandler 接口的 statusviewformoxiesdk 方法, 返回一个 android.app.fragment, 参考 Demo 里里的 StatusViewHandlerImpl.java 类 public class StatusViewHandlerImpl implements StatusViewHandler { public Fragment statusviewformoxiesdk() { return new ImportResultFragment(); 3. 第三步 : 将实现了了 StatusViewHandler 的类通过 setstatusviewhandle 设置, 如下 MoxieSDK.getInstance().setStatusViewHandler(new StatusViewHandlerImpl()); 5. 实现静默更更新 1. 第一步在 AndroidManifest.xml 里里面的 com.moxie.client.mainactivity 配置增加 android:theme="@android:style/theme.translucent.notitlebar" <activity android:name="com.moxie.client.mainactivity" android:windowsoftinputmode="adjustresize statealwayshidden" android:theme="@android:style/theme.translucent.notitlebar"> 2. 第二步

7 通过 MoxieSDK.getInstance().startInMode() 方法打开 sdk MoxieSDK.getInstance().startInMode(getActivity(), MoxieSDKRunMode.MoxieSDKRunModeBackground, mxparam, new MoxieCallBack(){ public boolean callback(moxiecontext moxiecontext, MoxieCallBackData moxiecallbackdata) { // 实现参考 Demo 里里的 BigdataFragment return false; ); 更更新日志 V 减小包大小 V 优化内部逻辑 V 修复设置 callbacktaskinfo 不不生效的问题 V2.3.1 V 优化网络请求 2. 修改 MxParam 的配置方式 3. 修复已知问题 V 优化导入 v2.2.0 支持支付宝无障碍辅助认证 v2.0.0 支持静默更更新 v 腾讯 x5 内核外置 3. MxParam 去掉 agreementurl 和 agreemententrytext 字段, 协议改为服务端配置 v 支持自定义导入页面 2. 减少 sdk 大小 v 优化支付宝二维码扫描体验 ( 支持截屏 ) v 增加错误日志收集 2. 优化支付宝二维码扫描体验 ( 直接打开支付宝进行行扫描 ) v 兼容 eclipse 的接入方式 v

8 1. 使用腾讯 x5 webview, 解决兼容性问题 2. 第三方官网页面自适应大小 v 回调增加 logindone 字段来判断是否登录成功 v1.3.2 修复支付宝账单解析失败的问题 v 增加沉浸式状态栏的支持 2. 物理理返回键的接口和任务回调接口合并 3. 修复 139 邮箱的重复登录失败的问题 v 全新的接入方式 2. 修复与 hibird app 的兼容性问题 3. 对上传文件加密, 更更安全 4. 增加同业爬取 5. 修复 quitlogindone 字段无法使用的情况 v 支付宝爬取框架升级, 支持淘宝支付宝互爬 2. actionbar 增加关闭按钮 v1.2.9 支付宝爬取的优化 v 导入进度页面支持通过 MxParam 传入自定义文字来替换默认的导入进度 2. 定制返回键或者 actionbar 返回按钮的行行为 3. 社保公积金金支持传入account, password 以完成自动登录 4. 支持自定义 title, 详情见补充事项十一 v 增加跳转到指定邮箱并完成自动登录的功能 2. 增加社保导入的功能 v 优化 webview 2. 增加邮箱账单导入从魔蝎 H5 跳转到官方H5 的功能 V 支持传入用户基本信息 ( 请看补充事项四 ) v 征信报告新版本发布 ( 请看补充事项三 ) 2. 网银支持自定义参数传入 ( 请看补充事项二 ) 3. 回调格式优化 ( 升级时必须注意!!! 具体请看 [5. 接收回调 ]) v1.2.3 增加设备指纹 v1.2.2 增加同意协议描述语的自定义传入 v1.2.1 优化 LINKEDIN 认证 v 网银 & 邮箱账单升级 2. 增加个税 3. progurad 优化 ( 代码有混淆时请务必更更新 progurad-rules.pro) v1.1.9 回调增加 account

9 v1.1.8 增加 linkedin 认证 v1.1.7 移除支付宝 API 登录和京东 API 登录 v1.1.6 增加法院失信人查询和被执行行人查询 v 增加爬取失败时自定义退出 Option 2. 回调增加 Message 字段 3. 回调增加 code=-4 的情况 v1.1.4 任务处理理日志上传 v1.1.3 增加脉脉认证 v 允许运营商传入手机号身份证和姓名 2. 改变打开 SDK 时的传递参数方式 ( 请根据文档对接 ) v 增加支付宝 & 京东后台认证接口 2. 修复 126& 阿里里云邮登录失败的问题 v 公积金金增加维护城市显示 2. 自定义 SDK 多种颜色 (Banner 颜色页面主题色 ) 3. 自定义用户使用协议

TVS厂商接入流程API文档

TVS厂商接入流程API文档 TVS 登录接入一. 登录验证流程 1. 厂商 APP-LWA-AVS 音箱 -AVS 验证流程 2. 厂商 APP- 微信开发平台 -TVS 后台 -TVS 音箱 -TVS 验证流程 3 厂商 APP-QQ 互联平台 -TVS 后台 -TVS 音箱 -TVS 验证流程二厂商 APP 接入 TVS 登录系统配置步骤 1. 打开工程 app 目录下的 build.gradle, (1) 确保