MoBagel 1.3.0

MoBagel 1.3.0

测试测试过的
语言语言 Obj-CObjective C
许可证 MIT
发布时间上次发布时间2016年12月

Ken Lin维护。



MoBagel 1.3.0

  • 作者:
  • KenLin

mobagel-ios-sdk

介绍

MoBagel 是一个实时云分析平台,它帮助物联网公司监测和分析硬件使用情况,加快研发进程,预测销售和营销策略,并主动与客户互动以防止产品退换。因此,公司还可以通过成本削减节省至数百万美元。

更多信息

使用方法

要运行示例项目,首先克隆仓库,然后从 Example 目录运行 pod install

安装

MoBagelSDK 可以通过 CocoaPods 获得。要安装它,只需将以下行添加到您的 Podfile 中

pod "MoBagel", '~> 1.3.0'

开始使用

- 创建账户

如果您没有账户,请在此处创建账户 这里。创建账户后,您将被定向到仪表盘。

- 创建新产品

要使用 MoBagel,您首先需要创建一个产品,它实际上是一组相同设备的集合。您第一次进入仪表盘时将被提示创建一个新产品。

创建产品后,您可以转到配置 -> 设备信息,以检索您的产品密钥,该密钥将在以后创建设备时使用。

- 添加自定义属性

在配置中,您可以为产品添加自定义属性。自定义属性应满足以下要求

  • ID:属性 ID(除状态外)应始终以 c_ 开头,以表示它是自定义属性。另请注意,属性 ID 是唯一的,不会重复。

  • Name:属性名称是您对属性的昵称。例如,如果您的 ID 是 'c_012421',则可以将名称设置为 'temperature'。仪表盘中的模块将显示您的属性名称而不是您的属性 ID。

  • Type:属性有两种类型:类别和数字。类别使用一组字符串选项,而数字使用数字选项(可选)。

  • 选项:

    • 类别:请在选项列中输入您属性的可能的字符串值。服务器将使用此功能来防止您的设备发送错误报告。

    • 数值(可选):请为您的数值属性设置最小和最大值,以帮助保护您的数据免受错误的影响。例如,如果您的数值属性是湿度级别,则可以将最小值设置为0,最大值设置为100。这将允许我们的系统拒绝任何湿度级别值在此范围之外的报告,因为这些值从理论上来说是不可能的(即负湿度级别)。

请注意,在您发送第一个自定义报告之前,您必须在配置中配置您的属性。

- 注册您的第一个设备

一旦您在仪表板上生成了一个product_key,您就可以使用product_key和registerDevice函数来在您的应用程序中注册一个设备。

#import <MoBagel/MoBagel.h>

MoBagelHandler* handler = [[MoBagelHandler alloc] init];
MoBagelClient* client = [MoBagelClient clientWithProductKey:productKey];

self.handler.apiHandler =  ^(NSInteger code, id responseObject) {
    // responseObject contain deviceId && deviceKey
    NSLog(@"ResponseObject: %@",responseObject);
};

self.handler.exceptionHandler =  ^(NSInteger code, id responseObject) {
    NSLog(@"Exception: %@",responseObject);
};
[client register:@{} handler:handler];

- 连接自定义属性或事件

在您的设备应用程序中,您需要在将报告发送到MoBagel之前准备您的报告。

  • 确定与您的报告一起发送的不同设备状态
# Example states

"state": "normal"
"state": "error"
  • 添加以d_(数字)或s_(字符串)开头的自定义属性或事件
# Example custom properties or events

"d_temperature": 30
"s_event": "turned_on"
  • 决定发送报告的时间、频率或事件

- 发送第一个报告

连接传感器属性后,您可以使用sendReport函数生成一个报告。

#import <MoBagel/MoBagel.h>

MoBagelHandler* handler = [[MoBagelHandler alloc] init];
MoBagelClient* client = [MoBagelClient clientWithDeviceKey:deviceKey];

self.handler.apiHandler =  ^(NSInteger code, id responseObject) {
    // responseObject contain deviceId && deviceKey
    NSLog(@"ResponseObject: %@",responseObject);
};

self.handler.exceptionHandler =  ^(NSInteger code, id responseObject) {
    NSLog(@"Exception: %@",responseObject);
};

NSDictionary* data = @{
    @"state": @"normal",
    @"d_temperature": @(30),
    @"s_event": @"turned_on",
};
[client report:data handler:handler];

更多

您可以访问我们的主页并获取更多信息。https://mobagel.com

作者

MoBagel,[email protected]

许可协议

MoBagel软件开发工具包(SDK)许可协议

在本许可协议的条款下,您在此获得一项全球性的、免版税的、不可转让的、非专有的和非再许可的许可,以使用、复制、修改和分发此软件(源代码或二进制形式),仅用于开发与MoBagel平台连接的应用程序。

MoBagel对所有SDK的合法权利、所有权和利益享有所有权。MoBagel保留了不明确授予您的所有权利。

MoBagel提供的SDK的形式和性质可能在没有事先通知您的情况下更改。此SDK提供“按原样”提供,不提供任何种类的保证,无论是明确的还是有限的。MoBagel可以自行决定(永久性或暂时性)在不事先通知的情况下停止向MoBagel用户提供服务。

您无权使用MoBagel的商标、徽标、域名或其他显著品牌特征。