iOS SDK 集成指南_v2.5

iOS SDK 集成指南_v2.5版本履历IOS SDK概述术语定义IOS SDK集成步骤1: 引入lib库步骤2:修改Bundle IDIOS SDK定义说明SDK状态说明设备类别(OMRONDeviceCategory)说明设备信息(OMRONDeviceInfo)说明数据说明用户敏感信息可见等级(OMRONSensitiveLogLevel)说明日志可见等级设置(OMRONLogPrintLevel)说明OMRONLib初始化状态(OMRONLibRegisterStatus)说明血压数据(OMRONBPObject)说明体脂数据(OMRONBFObject)说明血糖数据(OMRONBGObject)说明血氧数据(OMRONBOObject)说明IOS SDK接口说明1. 初始化SDK2. 根据设备类别获取可用设备列表3. 根据设备类别扫描周围设备3.1 扫描周围设备接口(旧版本接口:不区分绑定和同步状态,不推荐)3.2 停止扫描周围设备接口(旧版本接口:不区分绑定和同步状态,不推荐)3.3 调用扫描周围绑定状态设备的接口3.4 停止扫描周围绑定状态设备的接口3.5 扫描周围同步状态设备的接口3.6 停止扫描周围同步状态设备的接口3.7 SDK状态回调4. 取消设备连接绑定5. 血压计5.1 绑定血压设备5.2 获取血压设备数据5.3 血压计开启数据监听(旧版方法:只能监听一个设备,不推荐)5.4 多个血压计开启数据监听6. 体脂6.1 绑定体脂设备6.2 获取体脂设备数据6.3 体脂仪开启数据监听(旧版方法:只能监听一个设备,不推荐)6.4 多个体脂仪开启数据监听7. 血糖7.1 绑定血糖设备7.2 获取血糖设备数据7.3 血糖仪开启数据监听(旧版方法:只能监听一个设备,不推荐)7.4 多个血糖仪开启数据监听8. 血氧8.1 绑定血氧设备8.2 获取血氧设备数据8.3 血氧仪开启数据监听(旧版方法:只能监听一个设备,不推荐)8.4 多个血氧仪开启数据监听9. 数据监听9.1 数据监听是否已开启9.2 停止数据监听(停止数据监听通用接口)10 日志等级10.1 日志等级过滤输出10.2 信息脱敏等级设置11 设备指纹11.1 获取设备指纹SDK使用注意事项1. 个人信息说明2. 绑定个人信息说明3. 同步个人信息说明4. 血压计、体脂仪、血糖仪数据监听和取消监听说明

版本履历

  1. v2.5:增加独立授权设备限制。

  2. v2.4:增加应用限制、蓝牙连接状态返回、优化日志功能。

  3. v2.3:新增血氧仪HPO-201T,AF血压计U734T等设备的绑定和数据同步功能。

  4. v2.2:无网络时也能访问。

  5. v2.1:新增T50,U32,J732,J751,J760,U36J,U36T,HEM-6231T八款血压和一款HBF-229T体脂仪的绑定,数据监听,取消以及扫描周边设备的功能。

IOS SDK概述

术语定义

No.术语意义欧姆龙开放平台中的位置使用位置
1appKey应用的密钥(厂商key)。总览->应用->app-key参考《1. 初始化SDK》章节
2ekiKey设备密钥(设备授权key),保存了支持的设备信息。远程设备开放->设备信息一览->EkiKey参考《1. 初始化SDK》章节
3packageName应用包名(App包名)远程设备开放->开始集成->ios->应用包名参考《1. 初始化SDK》章节
4packageSecret应用秘钥(包名密码),在输入了ios的应用包名后显示。远程设备开放->开始集成->ios->应用秘钥参考《1. 初始化SDK》章节
5license设备独立授权下载的离线License文件远程设备开放->独立设备授权->License离线下载 
6thirdUserId第三方客户应用下用户识别码,可通过thirdUserId 锁定禁止用户使用sdk。thirdUserId长度不超过64位。  

IOS SDK集成

步骤1: 引入lib库

步骤2:修改Bundle ID

IOS SDK定义说明

SDK状态说明

设备类别(OMRONDeviceCategory)说明

设备信息(OMRONDeviceInfo)说明

数据说明

用户敏感信息可见等级(OMRONSensitiveLogLevel)说明
日志可见等级设置(OMRONLogPrintLevel)说明
OMRONLib初始化状态(OMRONLibRegisterStatus)说明
血压数据(OMRONBPObject)说明
体脂数据(OMRONBFObject)说明
血糖数据(OMRONBGObject)说明
血氧数据(OMRONBOObject)说明

IOS SDK接口说明

1. 初始化SDK

1.1 授权与用户管理配置

根据使用场景和网络依赖性,SDK 提供两种授权模式,区别如下:

特性在线模式离线模式
网络依赖首次激活需联网验证,后续操作可离线使用完全离线,无需任何网络连接
授权文件无需预置文件,license设置为nil需预置离线授权文件(从管理门户下载)通过iTunes或者其他开发者工具放置在当前项目文档目录(/Document)下
用户限制功能支持通过thirdUserId动态封禁用户(需联网同步黑名单)依赖本地授权文件,无法动态封禁用户
适用场景需定期验证授权状态或动态管理用户权限的场景无网络环境(如医疗设备专用平板)、对数据隐私要求极高的场景
激活方式自动联网验证appKeypackageSecret通过读取本地授权文件激活
功能限制支持远程更新设备授权列表功能固定,无法远程更新授权

配置选择建议

  1. 优先选择在线模式

    • 支持动态用户管理(如冻结异常账户)

    • 自动适配最新设备授权规则

    • 首次激活后仍可离线使用核心功能

  2. 强制离线场景选择离线模式

    • 需提前在管理门户生成设备指纹绑定的授权文件

    • 授权文件与设备强关联,不可跨设备复用

请根据使用场景选择对应的配置方式。

详细配置如下:

在线模式(无需离线授权文件)

离线模式(需预置授权文件)

用户权限控制(可选)

2. 根据设备类别获取可用设备列表

返回所支持设备列表

3. 根据设备类别扫描周围设备

3.1 扫描周围设备接口(旧版本接口:不区分绑定和同步状态,不推荐)

扫描指定类别的设备,不区分设备绑定状态和同步状态,不推荐

血压、体脂和血氧设备返回字段:statusdeviceNamedeviceIddeviceSerialNum 血糖设备返回字段:deviceSerialNumperipheral

3.2 停止扫描周围设备接口(旧版本接口:不区分绑定和同步状态,不推荐)
3.3 调用扫描周围绑定状态设备的接口

扫描指定类别的绑定状态的设备

3.4 停止扫描周围绑定状态设备的接口

扫描周围绑定状态设备接口的停止方法

3.5 扫描周围同步状态设备的接口

扫描已绑定的同步状态中的设备

3.6 停止扫描周围同步状态设备的接口

扫描周围同步状态设备接口的停止方法

3.7 SDK状态回调

监测当前SDK状态

4. 取消设备连接绑定

调用取消设备连接接口

5. 血压计

5.1 绑定血压设备

调用设备绑定接口传入绑定设备

5.2 获取血压设备数据

调用获取血压设备数据接口,传入设备类型以及绑定接口中返回的设备唯一码

5.3 血压计开启数据监听(旧版方法:只能监听一个设备,不推荐)

调用血压计数据监听接口,传入设备类型以及绑定接口中返回的设备唯一码,该接口不可与其他设备监听和数据同步接口同时使用

5.4 多个血压计开启数据监听

调用多个血压计数据监听接口,传入要监听的血压设备,该接口不可与其他设备监听和数据同步接口同时使用 可以同时监听多个设备,推荐。

6. 体脂

6.1 绑定体脂设备

调用设备绑定接口传入绑定设备类型,用户使用者,个人信息

6.2 获取体脂设备数据

调用获取体脂设备数据接口,传入设备类型、设备唯一码,用户使用者,用户信息以及绑定接口中返回的设备唯一码

6.3 体脂仪开启数据监听(旧版方法:只能监听一个设备,不推荐)

调用体脂仪数据监听接口,传入设备类型、设备唯一码,用户使用者,用户信息以及绑定接口中返回的设备唯一码,该接口不可与其他设备监听和数据同步接口同时使用

6.4 多个体脂仪开启数据监听

调用多个体脂仪数据监听接口,传入要监听的体脂设备,该接口不可与其他设备监听和数据同步接口同时使用 可以同时监听多个设备,推荐。

7. 血糖

7.1 绑定血糖设备

调用设备绑定接口传入绑定设备

7.2 获取血糖设备数据
7.3 血糖仪开启数据监听(旧版方法:只能监听一个设备,不推荐)

调用血糖仪数据监听接口,传入设备类型、设备唯一码,该接口不可与其他设备监听和数据同步接口同时使用

7.4 多个血糖仪开启数据监听

调用血糖仪数据监听接口,传入设备类型、设备唯一码,该接口不可与其他设备监听和数据同步接口同时使用 可以同时监听多个设备,推荐。

8. 血氧

8.1 绑定血氧设备

调用设备绑定接口传入绑定设备

8.2 获取血氧设备数据
8.3 血氧仪开启数据监听(旧版方法:只能监听一个设备,不推荐)

调用血氧仪数据监听接口,传入设备类型、设备唯一码,该接口不可与其他设备监听和数据同步接口同时使用

8.4 多个血氧仪开启数据监听

调用血氧仪数据监听接口,传入设备类型、设备唯一码,该接口不可与其他设备监听和数据同步接口同时使用 可以同时监听多个设备,推荐。

9. 数据监听

9.1 数据监听是否已开启
9.2 停止数据监听(停止数据监听通用接口)

调用停止数据监听接口,血压计、体脂仪、血糖仪、血氧仪共用该接口

10 日志等级

10.1 日志等级过滤输出
10.2 信息脱敏等级设置

11 设备指纹

11.1 获取设备指纹

SDK使用注意事项

1. 个人信息说明

2. 绑定个人信息说明

3. 同步个人信息说明

4. 血压计、体脂仪、血糖仪数据监听和取消监听说明