如何在自定义Android应用中通过Smart Things SDK实现三星智能设备的发现与配网？

1. 集成SmartThings Device Onboarding SDK（Android专属） #

三星提供了专门用于设备配网的Onboarding SDK，可直接在第三方Android应用中实现设备发现与配网：

• 集成步骤：
  • 在项目根目录build.gradle中添加三星Maven仓库：

    repositories {
        maven { url "https://developer.samsung.com/repository/" }
    }
    

  • 引入SDK依赖：

    dependencies {
        implementation 'com.samsung.android.sdk:smartthings-onboarding:1.0.0'
    }
    

  • 初始化并启动设备扫描：

    val onboardingManager = OnboardingManager.getInstance(context)
    onboardingManager.startDeviceScan(object : DeviceScanListener {
        override fun onDeviceFound(device: DiscoveredDevice) {
            // 处理发现的三星智能设备
        }
        override fun onScanFailed(errorCode: Int) {
            // 扫描失败的异常处理
        }
    })
    

  • 执行配网：调用onboardingManager.startOnboarding(device, wifiCredential)，传入设备实例和WiFi账号信息即可完成配网。
• 权限要求：在AndroidManifest.xml中添加ACCESS_WIFI_STATE、CHANGE_WIFI_STATE、ACCESS_COARSE_LOCATION权限，部分BLE设备还需BLUETOOTH_SCAN、BLUETOOTH_CONNECT权限。

2. 基于本地协议的自定义扫描方案 #

若SDK无法满足需求，可针对三星设备的通用协议实现自定义扫描：

• 针对WiFi设备：通过SSDP协议扫描，发送M-SEARCH请求到多播地址239.255.255.250:1900，过滤响应中ST: urn:schemas-samsung-com:device:SmartDevice:1的设备。
• 针对BLE设备：扫描广播中携带三星专属UUID（如0000FE95-0000-1000-8000-00805F9B34FB）的设备，解析广播数据获取设备信息。
• 配网实现：对支持SoftAP的设备，可连接设备热点后发送配网指令；部分设备支持SmartThings本地配网协议，需向三星申请协议文档权限后实现。

3. 申请三星开发者高级权限 #

若上述方法仍无法覆盖需求，可通过三星开发者后台申请设备控制高级权限：

• 提交权限申请后，可获取专属的配网API文档及技术支持，部分三星IoT设备的私有配网逻辑仅对授权开发者开放。

关键注意事项 #

• 全程避免依赖官方SmartThings App，所有扫描、配网逻辑需在自身应用内完成，禁止调用第三方App的隐式Intent。
• 不同型号三星设备的配网协议存在差异，需针对主流设备做兼容性测试。
• Android 10及以上版本扫描WiFi/BLE必须申请位置权限，需在代码中动态申请并引导用户授权。

内容的提问来源于stack exchange，提问作者Puja