# 应用客户端接入

# 应用需提供参数以及获取方式

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