Appearance
开发步骤
(1)注册星云账号并创建应用,得到client_id和client_secret。
(2)APP里导入APP SDK开发包,调用其中的方法,并实现相应的回调方法。
特别说明:暂不公开对外提供SDK,如有需要请联系客服咨询。
第一步:安装 SDK 依赖
- 将下载好的项目文件导入到自己的工程中,然后在工程根目录下的pubspec.yaml文件中添加依赖:
dependencies:
<插件昵称>:
path: <插件路径>- 工程根目录执行依赖同步:
flutter pub get3.工程iOS目录执行依赖同步:
pod install第二步:工程配置
Android配置
- 修改Android工程minSdkVersion
android {
defaultConfig {
minSdkVersion: 21
}
}- 添加相关权限申请 在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" />- 混淆配置
-keep class com.lib.flutter_blue_plus.* { *; }iOS配置
- 修改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可以直接发起业务接口调用,更多接口说明请参考《接口说明文档》章节。
