APPSDK FAQ

1 SDK认证为什么会失败?


  1. License 有问题。这种情况下会返回 -4023 的错误,请通过 DNAKit 来申请正确的控制 *License*。务必保证您的APP的包名与申请 License 时输入的一致。 image

  2. 网络有限制。这种情况下会返回 -4034 的错误,请确认路由器没有对 .ibroadlink.com.broadlink.com.cn 的域名进行过滤。SDK通过服务器的 *12345*端口进行认证,请确保没有重定向或者封闭该端口。上述问题都排除后,请联系 BroadLink技术支持 并且提供您的 License 供检查。 image

2 设备无法配置入网?


  1. 请务必保证设备处于配网模式 (蓝灯快闪为配网模式,慢闪表示联网中,蓝灯熄灭表示配网成功,可以长按REST键将设备复位到快闪模式)
  2. 请确认手机接入的是2.4G的网络,设备当前不支持5G(包括802.11n的5G和802.11ac),如果是双频路由器,可以将5G的WiFi名称改成和2.4G不一样的
  3. 若路由器为802.11n或者802.11bgn模式,请尝试将路由器设置为802.11bg模式,待设备配置成功之后,您可以重新改回去。这是为了保证路由器没有工作在802.11n的5G频段上
  4. 不支持路由器使用wep共享密钥的加密方式,请更换其他加密方式,推荐使用wpa2
  5. 其他配置不上的解决方案

3 设备已经成功入网了,为什么无法搜索到设备?


  1. 请确认设备与控制终端处于同一个局域网中,设备发现功能仅限于发现局域网内的设备
  2. 请确认您的路由器或者AP没有开启AP隔离(局域网内隔离)模式 image

  3. 若是概率性的搜索不到设备,请您检查您的局域网网络状况,由于设备发现使用的是局域网广播的原理,从协议层就无法保证百分百成功,建议您在局域网中且APP处于前台时,设置设备发现间隔,建议间隔时间为3秒钟

    [self.let.controller startProbe:3000]; // Start probe device
    self.let.controller.delegate = self;

4 设备搜索到了,设备配对失败了?


  1. 请确保设备与控制终端处于同一局域网中,设备配对仅限局域网内操作
  2. id和key是设备远程控制的必要参数,且必须保证值正确,id和key由设备生成,且只会在设备复位重新配置的情况下改变
  3. 请确保调用addDevice接口时,设备信息的完整性
    BLDNADevice *dnaDevice = [[BLDNADevice alloc] init];
    dnaDevice.pid = @"00000000000000000000000037270000";
    dnaDevice.did = @"0000000000000000000034ea34b3060e";
    dnaDevice.mac = @"34:ea:34:b3:06:0e";
    dnaDevice.name = @"智能遥控";
    dnaDevice.type = 10039;
    dnaDevice.password = 215625664;
    dnaDevice.controlId = 5;
    dnaDevice.controlKey = @"9bf3040cd1667b7b08daf16a3e4d685a";
    [[BLLet sharedLet].controller addDevice:dnaDevice];
  1. 请检查内网网络情况,若内网网络较差,可适当加大ltimeout的值

5 设备控制失败,返回-7错误?


  1. id和key是设备远程控制的必要参数,且必须保证值正确,id和key由设备生成,且只会在设备复位重新配置的情况下改变,返回-7必定是id和key的值不对
  2. 请确保设备已经成功进行配对操作,并且调用控制接口时,设备信息中已经包含了配对成功时返回的id和key
  3. 设备已经被认为复位了,设备复位之后,必需和设备再同一个局域网内再重新配对一次,并及时更新id和key
    BLPairResult *result = [[BLLet sharedLet].controller pair:device.did];
    NSLog(@"id:%ld,key:%@",(long)result.getId,result.getKey);

6 设备控制失败,返回-4000错误?


  1. 请检查网络状况,局域网控制可适当加大ltimeout的值,远程控制可适当加大rtimeout的值 objc [BLLet sharedLet].configParam.controllerLocalTimeout = 2000; [BLLet sharedLet].configParam.controllerRemoteTimeout = 4000;
  2. 若您是使用BroadLink的模块进行产品开发,请保证您的通信数据是否正确,您可以尝试通过透传方式先调通协议,然后再通过标准接口调试您的脚本,直到数据包正确

7 如何判断一个设备是否处于局域网中?


由于设备发现利用了局域网广播的原理,设备发现并不能保证每次都可以搜索到设备,根据我们的经验值来说,APP在前台时,并且处于Wi-Fi连接状态时,SDK会启动一个定时器,每3秒钟进行一次设备发现操作,若连续三次搜索不到设备,则认为设备已经离开局域网,反之可认为设备还处于局域网中。APP在后台时或者控制终端没有连接到Wi-Fi时,都可以认为设备不在局域网中。由于广播的原理,在设备离开局域网后,并不能立即知道,必然会存在一个超时时间,在这个超时时间内,会无法控制该设备。

typedef NS_ENUM(NSInteger, BLDeviceStatusEnum) {
    /** 初始化状态(未知) */
    BL_DEVICE_STATE_UNKNOWN = 0,
    /** 局域网状态 */
    BL_DEVICE_STATE_LAN = 1,
    /** 远程状态 */
    BL_DEVICE_STATE_REMOTE = 2,
    /** 离线状态 */
    BL_DEVICE_STATE_OFFLINE = 3
};

8 设备局域网控制成功,远程控制失败?


  1. 远程控制需要先登录,登录后查看SDK日志 auth result是否成功, 如果返回错误码-4037或sdk not register, please call SDKAuth first,则 auth失败 <appsdk_v2_faq.html#sdk> 认证成功的日志如下:
[BLLet DEBUG]Controller auth param: {"license":"CceFpDt7d+r4pZ8KP74tbpNSf9Ug9pP+ytpIXApsCYpvvDEid0s8SdJtKgQMc5QmUsWWVwAAAACvEX37zpG5Wgi\/Mlnda1pd2B9J96AQz9N0vO6WstfgR9yEgbkpFXFyJbsnfyHXt8pOdkTVo81rQrPhkOnhmpQBsEkbxXTfoUSQjDzWcfVjcAAAAAA=","account_id":"53356bc73e636b2dc50f3e5ca8b76b0c","account_session":"0d80378bc4cdaac90430d2fb86e7b7b9"}
[Debug]:networkapi_network.c,622 https server: 09c785a43b7b77eaf8a59f0a3fbe2d6eauth.ibroadlink.com:1998
[BLLet DEBUG]Controller auth result: {"lid":"09c785a43b7b77eaf8a59f0a3fbe2d6e","status":0,"msg":"sdk register success"}
  1. 远程控制返回-7,查看, 设备控制失败,返回-7错误
  2. 检查和设备接入服务是否畅通,手机网络 ping devicetype+access.ibroadlink.com

9 设备实际控制成功,但SDK返回控制失败?


  1. 设备实际控制成功,但SDK返回-4000,控制超时。

    这个是有可能出现的,因为SDK需要等待设备返回控制成功的包,如果超时时间到了,还没有收到包,SDK就会返回超时,可以通过 延长设备控制的超时时间 解决

10 设备状态一直是未初始化状态 0


  1. 设备发现后需要调用addDevice接口加入到SDK管理,SDK才会去查询它的状态
BLDNADevice *dnaDevice = [[BLDNADevice alloc] init];
    dnaDevice.pid = @"00000000000000000000000037270000";
    dnaDevice.did = @"0000000000000000000034ea34b3060e";
    dnaDevice.mac = @"34:ea:34:b3:06:0e";
    dnaDevice.name = @"智能遥控";
    dnaDevice.type = 10039;
    dnaDevice.password = 215625664;
    dnaDevice.controlId = 5;
    dnaDevice.controlKey = @"9bf3040cd1667b7b08daf16a3e4d685a";
    [[BLLet sharedLet].controller addDevice:dnaDevice];
  1. 刚加入SDK管理的设备,SDK还没有查询到状态,状态为 0,即未初始化状态,视网络状态,一般1-2秒就可以返回正确的状态
BLDeviceStatusEnum state = [[BLLet sharedLet].controller queryDeviceState:device.did];

typedef NS_ENUM(NSInteger, BLDeviceStatusEnum) {
    /** 初始化状态(未知) */
    BL_DEVICE_STATE_UNKNOWN = 0,
    /** 局域网状态 */
    BL_DEVICE_STATE_LAN = 1,
    /** 远程状态 */
    BL_DEVICE_STATE_REMOTE = 2,
    /** 离线状态 */
    BL_DEVICE_STATE_OFFLINE = 3
};

##11 设备绑定失败

设备绑定失败,返回:{"status":-2016,"msg":"bind fail”}

  1. 如果出现以上错误日志,无法远程控制,是该设备未添加到你的license中,需要在DNAkit平台添加该设备到license管理
  2. 登录DNAkit平台,平台接入——SDK接入——我的license里添加您需要控制的产品 DNAkit平台地址

12 设备控制返回-4020


  1. 设备控制依赖脚本解析命令,所以需要先下载对应设备的脚本才能进行控制
  2. 查看手机本地路径下,脚本文件是否存在,下载的脚本文件是否正确, iOS 默认脚本路径: xcappdata -> AppData -> Documents -> Let -> script 目录下 Android 默认路径: cache -> let -> script 目录下 文件格式: 设备pid.script 例:000000000000000000000000b54f0000.script

13 如何打印日志


  1. 日志可以有效帮助开发者分析SDK使用过程中遇到的问题, 日志等级分为BL_LEVEL_NONE,BL_LEVEL_ERROR,BL_LEVEL_WARN,BL_LEVEL_DEBUG,BL_LEVEL_ALL四个等级
  2. 如果遇到无法解决的问题,可以将日志等级设置成BL_LEVEL_ALL,并将完整日志提供给对接的技术支持分析
typedef NS_ENUM(NSUInteger, BLDebugLevelEnum) {
    /** 不打印 */
    BL_LEVEL_NONE = 0,
    /** 打印错误信息 */
    BL_LEVEL_ERROR = 1,
    /** 打印错误信息与警告信息 */
    BL_LEVEL_WARN = 2,
    /** 打印错误信息、警告信息以及调试信息 */
    BL_LEVEL_DEBUG = 3,
    /** 打印所有信息 */
    BL_LEVEL_ALL = 4
};

BLLet *let = [BLLet sharedLetWithLicense:@"Your License"];        // Init APPSDK
    [let setDebugLog:BL_LEVEL_ALL];                           // Set APPSDK debug log level
    [let.controller setSDKRawDebugLevel:BL_LEVEL_ALL];        // Set DNASDK debug log level