Last Updated on : 2024-07-31 03:39:27download
Device Control UI BizBundle for iOS is the core container of the control panel for each smart device within Tuya’s ecosystem. Based on Tuya Smart Life App SDK for iOS, the UI BizBundle encapsulates the APIs to load and control panels and accelerates the application development process. This UI BizBundle includes both the RN panel and the miniapp panel. If you want to integrate only the miniapp panel, see the MiniApp SDK documentation.
If you have not integrated the UI BizBundle before, you need to Integrate with Framework first.
The following features are supported:
Add the components of the Device Control UI BizBundle to the Podfile
and run the command pod update
.
source "https://github.com/TuyaInc/TuyaPublicSpecs.git"
source "https://github.com/tuya/tuya-pod-specs"
source 'https://cdn.cocoapods.org/'
platform :ios, '11.0'
target 'your_target_name' do
# ThingSmart SDK
pod "ThingSmartHomeKit"
# Adds the UI BizBundle.
pod 'ThingSmartPanelBizBundle'
# Depends on the IPC plug-ins to integrate with their features if needed.
# pod 'ThingSmartCameraRNPanelBizBundle'
# Depends on the health and fitness plug-ins to integrate with their capabilities if needed. Note that you must declare the permissions for the app to access the health and fitness capabilities. Otherwise, the request for launching the app on the App Store might be rejected.
# pod 'ThingSmartHealthExtendBizBundle'
# Depends on the robot vacuum plug-ins to integrate with their features if needed.
# pod 'ThingSmartSweeperExtendBizBundle'
# Depends on the smart speaker plug-ins to integrate with their features if needed.
# pod 'ThingSmartSpeakExtendBizBundle'
# pod 'AFNetworking', '~> 4.0.0'
# Depends on the home plug-ins provided by mini programs to integrate with their features if needed.
# pod 'TUNIHomeKit'
end
The UI BizBundle includes the open source React Native framework (v0.59.11).
If your iOS project does not integrate with React Native, follow the procedure in this topic to integrate with the UI BizBundle.
If your iOS project has integrated with React Native, perform the following steps to check whether the UI BizBundle can be integrated:
If both methods failed, the UI BizBundle cannot be integrated.
The UI BizBundle encapsulates a series of React Native API methods for panels. This requires specific declarations of privacy and permissions from Apple.
If a device panel supports album features such as the cloud album, add the following permission declaration to info.plist
of your project:
NSPhotoLibraryAddUsageDescription
If a device panel supports camera features such as the cloud album, add the following permission declaration to info.plist
of your project:
NSCameraUsageDescription
If a device panel supports location features, add the following permission declaration to info.plist
of your project:
NSLocationWhenInUseUsageDescription
If a device panel supports microphone features such as the music light panel, add the following permission declaration to info.plist
of your project:
NSMicrophoneUsageDescription
If a device panel supports Bluetooth features, add the following permission declaration to info.plist
of your project:
NSBluetoothAlwaysUsageDescription
NSBluetoothPeripheralUsageDescription
The UI BizBundle relies on the implementation of the protocol ThingPanelProtocol
to provide services. You can view the ThingPanelProtocol.h
file in the ThingModuleServices
component.
@protocol ThingPanelProtocol <NSObject>
NS_ASSUME_NONNULL_BEGIN
// Clears cached data of the panel.
- (void)cleanPanelCache;
/**
* Returns the device panel controller.
*
* @param deviceModel The device model.
* @param initialProps The custom initialization parameter to be set in `initialProps` of the RN application with the key 'extraInfo'.
* @param contextProps The context of the custom panel to be set in `Panel Context` with the key 'extraInfo'.
* @param completionHandler The callback returns the view controller.
*/
- (void)getPanelViewControllerWithDeviceModel:(ThingSmartDeviceModel *)deviceModel
initialProps:(nullable NSDictionary *)initialProps
contextProps:(nullable NSDictionary *)contextProps
completionHandler:(void (^ _Nullable)(__kindof UIViewController * _Nullable panelViewController, NSError * _Nullable error))completionHandler;
/**
* Returns the group panel controller.
*
* @param groupModel The group model.
* @param initialProps The custom initialization parameter to be set in `initialProps` of the RN application with the key 'extraInfo'.
* @param contextProps The context of the custom panel to be set in `Panel Context` with the key 'extraInfo'.
* @param completionHandler The callback returns the view controller.
*/
- (void)getPanelViewControllerWithGroupModel:(ThingSmartGroupModel *)groupModel
initialProps:(nullable NSDictionary *)initialProps
contextProps:(nullable NSDictionary *)contextProps
completionHandler:(void (^ _Nullable)(__kindof UIViewController * _Nullable panelViewController, NSError * _Nullable error))completionHandler;
// The RN version number.
- (NSString *_Nonnull)rnVersionForApp;
NS_ASSUME_NONNULL_END
@end
This UI BizBundle is used to load devices and implement features of different devices. For this purpose, implement the following dependent protocols:
ThingFamilyProtocol
ThingDeviceDetailProtocol
ThingSettingsProtocol
ThingOTAGeneralProtocol
ThingGroupHandleProtocol
ThingRNCameraProtocol
ThingCameraProtocol
These protocols are described in the following sections:
ThingFamilyProtocol
Provides current home information required by the UI BizBundle. This protocol must be implemented.
/**
Returns the current home. If the current user does not have a home, `nil` is returned.
@return ThingSmartHome
*/
- (ThingSmartHome *)getCurrentHome;
ThingDeviceDetailProtocol
Implements the activity of tapping and navigation in the top right corner of the device panel.
/**
Tap the button in the top right corner of the device panel to navigate to the device details page.
@param device The device.
@param group The group if any. It is optional.
*/
- (void)gotoDeviceDetailDetailViewControllerWithDevice:(ThingSmartDeviceModel *)device group:(ThingSmartGroupModel *)group;
ThingSettingsProtocol
Provides the optional switch to enable a certain sound effect on the app when device control DPs are sent. The following API method is implemented to return whether the sound effect is enabled:
/**
* Indicates whether the sound effect is enabled.
*/
- (BOOL)soundEnabled;
ThingOTAGeneralProtocol
Enters the device panel and checks for device firmware updates. The following API method is implemented to check for device firmware updates:
/**
Checks for device firmware updates, and if any, shows the update prompt.
@param deviceModel The device that checks for firmware updates.
@param isManual Specifies whether to enable manual checks for firmware updates.
@param theme The theme color.
`YES`: Manually check for updates. A loading dialog box appears during the check. If a new update is found (check for updates, forced updates, and update notifications), OTA VC is displayed.
`NO`: Automatically check for updates. A loading dialog box does not appear during the check. When forced updates and update notifications are enabled, the firmware update prompt appears. Click **OK** to show OTA VC.
*/
- (void)checkFirmwareUpgrade:(ThingSmartDeviceModel *)deviceModel isManual:(BOOL)isManual theme:(ThingOTAControllerTheme)theme;
ThingGroupHandleProtocol
Implements the activity of navigation to a mesh group page on the panel for a Bluetooth mesh device. The following API method is implemented:
/**
Navigates to a local mesh group.
@available 1.0.0
@param params
@param success
@param failure
*/
- (void)impl_jumpToMeshLocalGroup:(NSDictionary*)params success:(RCTResponseSenderBlock)success failure:(RCTResponseErrorBlock)failure ;
ThingRNCameraProtocol
Navigates to and loads the RN panel for an IPC. If the BizBundle ThingSmartCameraRNPanelBizBundle
is integrated, this protocol is not required.
/**
Returns the IPC RN panel.
@param devId The device ID of the IPC.
*/
- (UIViewController *)cameraRNPanelViewControllerWithDeviceId:(NSString *)devId;
ThingCameraProtocol
Navigates to and loads the native panel for an IPC. If the BizBundle ThingSmartCameraPanelBizBundle
is integrated, this protocol is not required.
/**
Returns the IPC native panel.
@param devId The device ID of the IPC.
@param uiName The UI name of the IPC. The value varies depending on different panel versions.
*/
- (UIViewController *)viewControllerWithDeviceId:(NSString *)devId uiName:(NSString *)uiName;
getCurrentHome
method provided by the protocol ThingFamilyProtocol
must be implemented first.Objective-C:
#import <ThingSmartBizCore/ThingSmartBizCore.h>
#import <ThingModuleServices/ThingFamilyProtocol.h>
- (void)initCurrentHome {
// Registers the protocol to be implemented.
[[ThingSmartBizCore sharedInstance] registerService:@protocol(ThingFamilyProtocol) withInstance:self];
}
// Implements the protocol method.
- (ThingSmartHome *)getCurrentHome {
ThingSmartHome *home = [ThingSmartHome homeWithHomeId:@"Current home ID"];
return home;
}
Swift:
import ThingSmartDeviceKit
class ThingActivatorTest: NSObject,ThingFamilyProtocol{
func test() {
ThingSmartBizCore.sharedInstance().registerService(ThingFamilyProtocol.self, withInstance: self)
}
func getCurrentHome() -> ThingSmartHome! {
let home = ThingSmartHome.init(homeId: 111)
return home
}
}
Objective-C:
id<ThingPanelProtocol> impl = [[ThingSmartBizCore sharedInstance] serviceOfProtocol:@protocol(ThingPanelProtocol)];
[impl cleanPanelCache];
Swift:
let impl = ThingSmartBizCore.sharedInstance().service(of: ThingPanelProtocol.self) as? ThingPanelProtocol
impl?.cleanPanelCache()
Objective-C:
id<ThingPanelProtocol> impl = [[ThingSmartBizCore sharedInstance] serviceOfProtocol:@protocol(ThingPanelProtocol)];
// Returns the panel view controller and enables automatic navigation.
if (deviceModel) {
[impl gotoPanelViewControllerWithDevice:deviceModel group:nil initialProps:nil contextProps:nil completion:^(NSError * _Nullable error) {
}];
} else if (groupModel) {
[impl gotoPanelViewControllerWithDevice:nil group:groupModel initialProps:nil contextProps:nil completion:^(NSError * _Nullable error) {
}];
}
Swift:
let impl = ThingSmartBizCore.sharedInstance().service(of: ThingPanelProtocol.self) as? ThingPanelProtocol
// Returns the panel view controller and enables automatic navigation.
impl?.gotoPanelViewController(withDevice: deviceModel, group: nil, initialProps: nil, contextProps: nil, completion: { (error: Error?) in
})
impl?.gotoPanelViewController(withDevice: nil, group: groupModel, initialProps: nil, contextProps: nil, completion: { (error: Error?) in
})
Is this page helpful?
YesFeedbackIs this page helpful?
YesFeedback