Limbic iOS SDK

Limbic 的 iOS 应用于压力检测的 AI

安装

CocoaPods

要使用 CocoaPods 在 Xcode 项目中集成 Limbic，将其添加到您的 Podfile

对于非 Xcode 测试版构建

pod 'Limbic', '~> 0.0.25’

对于 Xcode 测试版构建

pod 'Limbic', '~> 0.1.0’

然后，运行以下命令

$ pod install

使用方法

1. 在您的应用程序代理中导入 Limbic 框架头文件

   // Swift
   import Limbic

   // Objective-C
   #import <Limbic/Limbic.h>

2. 将以下内容添加到应用程序代理的 方法中。

   // Swift
   Limbic.apiKey = "YOUR_API_KEY"

   // Objective-C

   请确保将 YOUR_API_KEY 替换为您的应用程序令牌。在此申请我们的测试版 这里.

3. 当您准备好向用户展示压力水平时，首先创建一个实例。

   // Swift
   let limbic = Limbic()

   然后，按照以下示例调用压力函数。

   // Swift
   limbic.getStressforCurrentUser(startDate: Date(), endDate: Date()) { stress in
       // for information on return values, see below
       print(stress)
   }

辅助函数

// Swift
limbic.getLastDayStressForCurrentUser { stress in
    print(stress)
}
    
limbic.getLastWeekStressForCurrentUser { stress in
    print(stress)
}
    
limbic.getLastMonthStressForCurrentUser { stress in
    print(stress)
}

limbic.getLastYearStressForCurrentUser { stress in
    print(stress)
}

返回值

"2018-05-29 23:00:00 +0000" = {
  confidence = "1.000001054754341";
  confidenceLevel = 2;
  stressIndex = 0;
  stressLevel = 4;
};

• confidence 表示我们 95% 置信 stressIndex 落在其中的 置信区间。
• confidenceLevel 可以是 1 或 2。 1 代表 确定，而 2 代表 不确定。这是对压力预测的确定性。
• stressIndex 是一个指标，它根据个人的压力水平基准计算得出。任何超过 0 的值都表示 比平均水平更紧张，任何低于平均水平的都表示 比平均水平更放松。
• stressLevel 是推荐用来报告用户压力水平的指标。值可以从 1 到 7。以下是所有可能值的分解

1 -- A very calm day
2 -- A calm day
3 -- A slightly calm day
4 -- A normal day
5 -- A slightly stressful day
6 -- A stressful day
7 -- A very stressful day

请注意，我们推荐使用 stressLevel 和 confidenceLevel，因为这些值更容易被用户理解。

注释

为了防止您的应用被拒绝，您需要将以下键添加到您的应用 info.plist 文件中，并使用文本说明为何需要这些权限

• NSHealthShareUsageDescription

如果您的应用还没有访问 healthKit，我们建议添加类似的行

• "<应用名称> 需要访问您的健康数据以呈现准确的压力水平预测。"

同样重要的是，您需要在项目的能力页面中选择将 Healthkit 权限打开。

访问 HealthKit 的权限提醒 不会出现，除非调用其中一个压力方法并且尚未授予权限。

请参见下方的流程图描述，说明当调用压力函数之一时的操作流程：

如何控制 Limbic 请求权限的时间？

我们正在开发一个功能，让您能够完全控制请求权限的时间。目前，请求权限的最佳方式是请求流程图中列出的所有权限，并将它们添加到您的应用程序请求权限的地方。如图所示，Limbic仅在权限未设置的情况下才会请求权限。如果用户已接受或拒绝HealthKit数据共享请求，那么Limbic将不再请求该权限。