SpacerSDK 1.6.0

SpacerSDK 1.6.0

SPACER 维护。



SpacerSDK 1.6.0

  • SPACER Co., Ltd.

SpacerSDK

code platforms bluetooth license

提供使用 SPACER 储物柜的操作。

更多信息,请参阅 文档

功能

1. CB 储物柜服务

提供使用 BLE 的储物柜操作

  • 扫描储物柜
  • 将您的行李存放在储物柜中
  • 从储物柜中取出您的行李
  • 临时解锁储物柜

2. 我的储物柜服务

提供您正在使用的储物柜的操作

  • 获取正在使用的储物柜
  • 预订可用的储物柜
  • 取消已预订的储物柜
  • 分享您正在使用的储物柜
  • 获取正在使用的维护储物柜

3. SPR 储物柜服务

提供基本的储物柜信息

  • 获取多个储物柜的基本信息
  • 获取多个储物柜单元的基本信息

4. 位置服务

提供基本的位置信息

  • 获取多个单元的基本位置信息

要求

  • iOS 11.0+
  • 低功耗蓝牙 (BLE) 4.2+

使用方法

蓝牙权限设置

「info.plist」→「打开为」 →「源代码」

请添加以下键和值
请将值中的文字更改为您公司适当的文字

<dict>
    <key>NSBluetoothAlwaysUsageDescription</key>
    <string>Used to detect lockers.</string>
    <key>NSBluetoothPeripheralUsageDescription</key>
    <string>Bluetooth is used to communicate with BLE devices.</string>

位置权限设置

「info.plist」→「打开为」 →「源代码」

请添加以下键和值
请将值中的文字更改为您公司适当的文字

<dict>
    <key>NSLocationWhenInUseUsageDescription</key>
    <string>Used to detect lockers.</string>

1. CB 储物柜服务

import SpacerSDK

let cbLockerService = SPR.cbLockerService()

// Scan lockers
cbLockerService.scan(
    token: token,
    success: { sprLockers in
    },
    failure: { error in
    }
)
   
// Deposit your luggage in the locker    
cbLockerService.put(
    token: token,
    spacerId: spacerId,
    success: {
    },
    failure: { error in
    }
)

// Take your luggage out of the locker   
cbLockerService.take(
    token: token,
    spacerId: spacerId,
    success: {
    },
    failure: { error in
    }
)

// Temporarily unlock locker
cbLockerService.openForMaintenance(
    token: token,
    spacerId: spacerId,
    success: {
    },
    failure: { error in
    }
)

2. 我的储物柜服务

import SpacerSDK

let myLockerService = SPR.myLockerService()

// Get a locker in use
myLockerService.get(
    token: token,
    success: { myLockers in
    },
    failure: { error in
    }
)

// Reserve an available locker
myLockerService.reserve(
    token: token,
    spacerId: spacerId,
    success: { myLocker in
    },
    failure: { error in
    }
)

// Cancel the reserved locker
myLockerService.reserveCancel(
    token: token,
    spacerId: spacerId,
    success: {
    },
    failure: { error in
    }
)

// Share your locker in use
myLockerService.shareUrlKey(
    token: token,
    urlKey: urlKey,
    success: { myLocker in
    },
    failure: { error in
    }
)

// Get maintenance lockers in use
myLockerService.getMyMaintenanceLocker(
    token: token,
    success: { myMaintenanceLockers in
    },
    failure: { error in
    }
)

3. SPR 储物柜服务

import SpacerSDK

let sprLockerService = SPR.sprLockerService()

// Get multiple locker basic information
sprLockerService.get(
    token: token,
    spacerIds: spacerIds,
    success: { sprLockers in
    },
    failure: { error in
    }
)

// Get multiple locker unit basic information
sprLockerService.get(
    token: token,
    unitIds: unitIds,
    success: { sprUnits in
    },
    failure: { error in
    }
)

4. 位置服务

import SpacerSDK

let locationService = SPR.locationService()

// Get multiple unit location basic information
locationService.get(
    token: token,
    locationId: locationId,
    success: { sprLocation in
    },
    failure: { error in
    }
)

示例

您可以在 Example 项目中检查 Spacer SDK 的操作。请参阅 示例代码

使用方法

  1. 打开 Example 项目
  2. 在环境变量中设置 SDK_TOKEN 的值
  3. 在 iPhone 上构建和运行

关于 SDK_TOKEN

最初,从您的服务器获取的 SPACER 发起的令牌设置为测试。

如何获取 sdk.token,请参阅 文档

安装

CocoaPods

pod 'SpacerSDK'

Swift 包管理器

dependencies: [
    .package(url: "https://github.com/spacer-dev/spacer-sdk-ios.git", .upToNextMajor(from: "1.1.0"))
]

许可证

本软件根据 MIT 许可协议发布,请参阅 LICENSE。