☰
Navigation :

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 文件内，加入指定 Source 为 https://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