Device Control SDK Usage

1. Overview

This article describes how to use the Device Control SDK APIs, such as navigating to device pages.

Important Change

Starting from the latest SDK version, device page navigation is unified through LMSDKDeviceRouter.framework. This framework automatically routes to the correct page based on the device access type (native, RN, H5, camera, etc.). All new integrations should use this API.

The legacy approach of calling vertical SDK navigation APIs directly has been deprecated. Please use LMSDKDeviceRouter for all device page navigation.

2. Preconditions

1. Complete Preparation
2. Complete Environment Build
3. Complete Device Control SDK Integration

3. Usage

3.1 Navigate to Device Control Home Page (Recommended)

Import the header:

#import <LMSDKDeviceRouter/LMSDKDeviceRouter.h>

import LMSDKDeviceRouter

Objective-C example:

[LMSDKDeviceRouter pushToDeviceControlPageWithDevice:device
                                navigationController:self.navigationController
                                            animated:YES
                                          completion:^(NSError * _Nullable error, id _Nullable result) {
    if (error) {
        // Handle navigation failure
    }
}];

Swift example:

LMSDKDeviceRouter.pushToDeviceControlPage(with: device,
                                          navigationController: self.navigationController,
                                          animated: true) { error, result in
    if let error = error {
        // Handle navigation failure
    }
}

Parameter description

LMSDKDeviceRouter automatically identifies the device access type by model and navigates to the corresponding page (native control, RN plugin, camera playback, etc.). You no longer need to manually determine the device category and call different SDK APIs.

3.2 Navigate to Device Settings / Detail Page

[LMSDKDeviceRouter pushToDeviceDetailPageWithDevice:device
                               navigationController:self.navigationController
                                           animated:YES
                                         completion:^(NSError * _Nullable error, id _Nullable result) {
}];

LMSDKDeviceRouter.pushToDeviceDetailPage(with: device,
                                         navigationController: self.navigationController,
                                         animated: true) { error, result in
}

3.3 Navigate by Page Type

When you need to explicitly specify the target page:

[LMSDKDeviceRouter pushToDevicePageWithDevice:device
                                     pageType:LMSDKDevicePageTypeControl
                         navigationController:self.navigationController
                                     animated:YES
                                  extraParams:nil
                                   completion:^(NSError * _Nullable error, id _Nullable result) {
}];

pageType values

4. Notes

For camera devices, using LMSDKDeviceRouter to navigate to the control home page automatically routes to the camera playback page. See Camera SDK Integration.

LHDeviceRouter is internal routing in LMMeshDriver_UI for SDK widget callbacks; host apps should not call it directly.