客户端接入(IOS)

IOS客户端接口人: 叶旸

下载WiFi万能钥匙帐号SDK(iOS 版)

IOS资源下载

SDK文件包括 libWKAuth.a,WKAuth.h,WKApiObject.h 三个。

搭建开发环境

在info.plist中 LSApplicationQueriesSchemes一栏增加 LinksureWiFi 和 LanternWiFi, 记得iOS9以后需要设置url的白名单,否则判断WiFi万能钥匙安装与否可能会误判。

ios搭建开发环境

在Xcode中,选择你的工程设置项,选中“TARGETS”一栏,在“info”标签栏的“URL type“添加“URL scheme”为你所注册的应用程序id(如下图所示)

ios环境

Xcode设置URL scheme 在你需要使 用WiFi万能钥匙终端API的文件中import WKAuth.h 头文件,并增加 WKApiDelegate 协议。 ios-3

在代码中使用开发工具包

1.要使你的程序启动后WiFi万能钥匙终端能响应你的程序,必须在代码中向WiFi万能钥匙终端注册你的id。(如下图所 示,在 AppDelegate 的 didFinishLaunchingWithOptions 函数中向WiFi万能钥匙注册id)。

ios-4

2.重写AppDelegate的handleOpenURL和openURL方法:

ios-5

3.现在,你的程序要实现和WiFi万能钥匙终端交互的具体请求与回应,因此需要实现WKApiDelegate协议的两个 方法 ios-6

移动应用WiFi万能钥匙授权登录

移动应用WiFi万能钥匙授权登录 开发者需要配合使用WiFi万能钥匙提供的SDK进行授权登录请求接入。 正确接入SDK后,开发者移动应用会在终端 本地拉起WiFi万能钥匙应用进行授权登录,WiFi万能钥匙用户确认后WiFi万能钥匙将拉起开发者移动应用,并带上授权临时 票据(code)。 如果未安装钥匙,会吊起web端的登录授权。

iOS平台应用授权登录接入代码示例

(void)sendAuthRequest
{
       // 构造SendAuthReq 结构体
      WKSendAuthReq *req = [WKSendAuthReq new];
      //应用授权作用域
     req.scope = @"USERINFO";
      //第三方向往能钥匙终端发送一个WKSendAuthReq消息结构
    [WKAuth sendReq:req delegate:self];
}

授权成功后,回调 onWKResp:(WKBaseResp *)resp ,即可获取授权临时票据(code)