Skip to content

开发步骤

(1)注册星云账号并创建应用,得到client_id和client_secret。

(2)APP里导入APP SDK开发包,调用其中的方法,并实现相应的回调方法。

特别说明:暂不公开对外提供SDK,如有需要请联系客服咨询。

第一步:安装 SDK 依赖

  1. 将下载好的项目文件导入到自己的工程中,然后在工程根目录下的pubspec.yaml文件中添加依赖:
dependencies:
  <插件昵称>:
   path: <插件路径>
  1. 工程根目录执行依赖同步:
  flutter pub get

3.工程iOS目录执行依赖同步:

  pod install

第二步:工程配置

Android配置

  1. 修改Android工程minSdkVersion
 android {
  defaultConfig {
     minSdkVersion: 21
     					}
     		}
  1. 添加相关权限申请 在android/app/src/main/AndroidManifest.xml文件中,添加如下权限申请:
<uses-feature android:name="android.hardware.bluetooth_le" android:required="false" />
<!-- New Bluetooth permissions in Android 12
https://developer.android.com/about/versions/12/features/bluetooth-permissions -->
<uses-permission android:name="android.permission.BLUETOOTH_SCAN" android:usesPermissionFlags="neverForLocation" />
<uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />
<!-- legacy for Android 11 or lower -->
<uses-permission android:name="android.permission.BLUETOOTH" android:maxSdkVersion="30" />
<uses-permission android:name="android.permission.BLUETOOTH_ADMIN" android:maxSdkVersion="30" />
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" android:maxSdkVersion="30"/>
<!-- legacy for Android 9 or lower -->
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" android:maxSdkVersion="28" />
  1. 混淆配置
-keep class com.lib.flutter_blue_plus.* { *; }

iOS配置

  1. 修改iOS工程中 ios/Runner/Info.plist 文件,添加蓝牙相关权限说明:
	<key>NSBluetoothAlwaysUsageDescription</key>
	<string>The app uses bluetooth to find, connect and transfer data between different devices</string>
	<key>NSBluetoothPeripheralUsageDescription</key>
	<string>The app uses bluetooth to find, connect and transfer data between different devices</string>

第三步:SDK初始化、创建星云账号、设置星云账号

初始化说明:SDK的初始化为轻量操作,可以根据业务需要,随时进行初始化工作,只要在发起SDK接口调用前即可。

  • SDK初始化   通过开发步骤中获取到的clientId和clientSecret对SDK进行初始化。
StarCloudSDK.init(clientId:’clientId‘,clientSecret:'clientSecret',environmentUrl:'星云域名');
  • 创建星云账号   需要为不同用户创建一个星云账号,用来管理用户的星云数据。
StarCloudSDK.instance.createCloudUser(
      onSuccess: (CloudUserInfo cloudUserInfo) async {
      // 在这里可以将云账号信息绑定到自己的业务账号上,后续直接从自己业务系统中获取云账号即可。

      },
      onError: (Object? err) {
      //异常情况处理
      },
    )
  • SDK设置星云账号   SDK中大部分跟锁相关的接口调用都依赖星云账号,因此需要提供相应的星云账号。
StarCloudSDK.instance.setCloudAccounts(<CloudUserInfo>[cloudUserInfo]);

设置星云账号后,星云SDK会自动完成身份信息验证,App可以直接发起业务接口调用,更多接口说明请参考《接口说明文档》章节。

物联网设备通信协议文档