APPSDK 接入集成说明

1 License 申请

为了设备的安全,所有使用SDK的用户必须向 BroadLink DNAKit 开发者平台 申请 License

注意:License 必须与应用的包名(PackageName)相关联,不同的应用包名需要申请不同的 License。

申请流程(图文):

  1. 进入 BroadLink DNAKit 开发者平台
  2. 登录账号,没有账号的请先注册,并申请为开发者
  3. 等待审核通过
  4. 审核通过后,进入主页,选择 平台接入 -> SDK接入
  5. 选择 License申请 -> *新建License申请*,按要求填写信息,若要控制第三方厂家的设备,请在备注中说明厂家的名称以及具体的产品型号,提交审核
  6. 审核通过之后,可以在申请页面看见 License

2 Android 工程配置

由于原有 Jcenter 服务器暂停,Android SDK 下载集成修改为 Jitpack 服务器。需要修改为如下方式:

本SDK目前编译配置为:

android {
    compileSdkVersion 23
    buildToolsVersion "23.0.3"

    defaultConfig {
        minSdkVersion 8
        targetSdkVersion 23
    }
}
  1. 在工程的 build.gradle 文件内添加如下:
    allprojects {
        repositories {
            maven {
              url "https://jitpack.io"
              credentials { username "jp_1a8mdfk363dfb7ebvqrcoovtpq" }
            }
        }
    }
  1. 在APP目录下的 build.gradle 文件内添加如下:
    dependencies {
        compile fileTree(include: ['*.jar'], dir: 'libs')

		implementation 'com.github.broadlinksdk:BLLetBaseAndroid:2.15.1'
        implementation 'com.github.broadlinksdk:BLLetCoreAndroid:2.17.1'
        implementation 'com.github.broadlinksdk:BLLetIRCodeAndroid:2.14.10'
        implementation 'com.github.broadlinksdk:BLLetAccountAndroid:2.13.3'
        implementation 'com.github.broadlinksdk:BLSFamilyAndroid:1.0.8'
    }
  1. 需要在 AndroidManifest.xml 添加以下权限,或者在调用SDK出动态申请以下权限
    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
    <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
    <uses-permission android:name="android.permission.CHANGE_WIFI_MULTICAST_STATE" />
    <uses-permission android:name="android.permission.INTERNET" />

特殊说明

android.permission.WRITE_EXTERNAL_STORAGE 权限为高危权限, SDK 在控制时需要下载控制脚本到本地,开发者可自行决定是否授予该权限。 如果本地没有脚本,无法使用dnacontrol接口控制。

iOS 工程配置

SDK支持 iOS 8.0 以后版本,支持以下配置方式:

Cocoapods 导入

cocoapods 导入说明:

  1. cocoapods 相关安装说明, 请参考 Cocoapods官网
  2. 在 Podfile 文件内,加入指定 Sourcehttps://github.com/ibroadlink/BLLibSpecs.git
  3. 如果需要导入 BLLetCore ,则需要在 Podfile 文件内,加入: pod 'BLLet', '~> 2.17'

Podfile 示例:

    source 'https://github.com/ibroadlink/BLLibSpecs.git'
    source 'https://github.com/CocoaPods/Specs.git'

    target 'BLAPPSDKDemo' do
        pod 'BLLet', '~> 2.17'
    end