# 应用客户端接入
# 应用需提供参数以及获取方式
CISS接入参数
| 提供方 | 参数名称 | 说明 | 获取方式 | 备注 |
|---|---|---|---|---|
| 应用名称 | 应用的名字和功能描述 | |||
| 应用 | BUNDLE ID | IOS APP创建的Bundle ID | XCode 可查 | (必须提供) |
| 应用 | 应用平台出口IP地址 | 平台接口限制应用只能从应用平台IP调用此接口。 | 应用平台网络维护人员 | 调用CISS提供的接口需要 |
| CISS平台 | CISS AppId | 传给应用APPid,用来和ciss交互 | 提供第三第四列参数后申请通过即返回 | 重要参数不可泄漏 |
| CISS平台 | CISS AppKey | 传给应用APPKey,用来和ciss交互以及加密通讯使用 | 提供第三第四列参数后申请通过即返回 | 重要参数不可泄漏 |
# 相关文件及参数
# 开发环境
编译器:XCode
IOS 版本:12及以上
# 所需权限
| 动态申请 | |
|---|---|
| 蓝牙权限 | Privacy - Bluetooth Always Usage Description |
| 蓝牙权限 | Privacy - Bluetooth Peripheral Usage Description |
# 添加库文件
将 libCISSApiLib.a和include (不同版本a文件名会有不同) 文件,添加到XCode中。
# 项目配置
- 在 TARGETS General确保Frameworks, Libraries, and Embedded Content中引入libCISSApiLib.a。
# 添加启动app时的初始化操作:
@interface ViewController ()<CISSProgressDelegate>
@end
@implementation ViewController
- (void)viewDidLoad {
[[SimKey sharedSimKey] initSimkey:@"从平台获取的CISS AppId" bundle:@"提交给平台的BUNDLE ID" key:@"从平台获取的CISS AppKey"];
NSError *err;
ConnectConfig *cfig = [[ConnectConfig alloc] init];
//当使用mac地址识别SimKey盾时
cfig.mac = @"SimKey卡盾MAC地址";
cfig.type = NSConnectWithMac;
//当使用手机号识别SimKey盾时
cfig.phoneNum = @"SimKey卡盾手机号";
cfig.type = NSConnectWithPhoneNum;
cfig.noticeServer = YES;//YES:通知服务器 NO:不通知服务器
BOOL connResult = [[CISS sharedCISS:self] connectService:cfig error:&err];
}
#pragma mark - CISSProgressDelegate
- (void)cissManagerStartAction:(NSString *)description{
//开始被调用
}
- (void)cissManagerDoingAction:(NSString *)description{
//正在被调用
}
- (void)cissManagerFindError:(NSInteger)ErrorCode andErrorDescription:(NSString *)description{
//执行遇到错误时调用
}
- (void)cissManagerFinishAction:(NSString *)description{
//执行结束时调用
}
@end
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40