Fast Integration with IPC SDK for iOS

IPC SDK helps you implement IP camera (IPC) functionalities on top of the modules provided by Cube App SDK, such as user management, device pairing, home management, and device management. Therefore, the Cube App SDK must be integrated before you integrate or update the IPC SDK for your project. For more information, see Fast Integration with Cube App SDK for iOS.

Modules

Set up the environment

Integrate with the SDK

Add the following code block to the Podfile:

source 'https://github.com/tuya/tuya-pod-specs.git'
platform :ios, '11.0'

target 'your_target_name' do
  # Build and get ThingSmartCryption from the Tuya Developer Platform (https://platform.tuya.com).
  # After the official edition is purchased, rebuild the SDK on the Tuya Developer Platform and integrate it into your project.
  # The dot slash (./) notation represents that the files that are obtained after ios_core_sdk.tar.gz is extracted are put to the directory at the same directory as podfile.
  # To use another directory, change the path to your desired directory.
  pod "ThingSmartCryption", :path =>'./'
  pod "ThingSmartCameraKit"
end

Add permissions

The IPC SDK requires permissions to access the album and use the microphone. Make sure you have added the following permission declaration to info.plist of your project. Otherwise, the app might crash during video recording, screenshot capturing, or video talks.

// Add the following permission declaration to info.plist of your project.
Privacy - Microphone Usage Description
Privacy - Photo Library Additions Usage Description

Initialize the SDK

1. Open the project settings, click Target > General, and then modify Bundle Identifier to the iOS Bundle ID of the app that is registered on the Tuya Developer Platform.

2. Add the following content to the PrefixHeader.pch file of the project. For a Swift project, the following content can be added to the bridging header file xxx_Bridging-Header.h.

   #import <ThingSmartBaseKit/ThingSmartBaseKit.h>
   #import <ThingSmartCameraKit/ThingSmartCameraKit.h>
   

3. Open the AppDelegate.m file and initialize the SDK by calling the method [AppDelegate application:didFinishLaunchingWithOptions:]. The values of AppKey and AppSecret generated on the Tuya Developer Platform are used for the initialization.

   • Objective-C:

     [[ThingSmartSDK sharedInstance] startWithAppKey:<#your_app_key#><#your_app_key#> secretKey:<#your_secret_key#>];
     

   • Swift:

     ThingSmartSDK.sharedInstance()?.start(withAppKey: <#your_app_key#>, secretKey: <#your_secret_key#>)
     

Now, the SDK is activated and you are ready for app development.

Modify the main function

After the video is streamed, the app goes to the background, stays for a while, and then comes back to the foreground. This might cause the app to crash. Error message: Terminated due to signal 13. To prevent this crash, add the following code block to the project:

• Objective-C: main.m

  int main(int argc, char * argv[]) {
      @autoreleasepool {
  
          struct sigaction sa;
          sa.sa_handler = SIG_IGN;
          sigemptyset(&sa.sa_mask);
          sa.sa_flags = 0;
  
          if (sigaction(SIGPIPE, &sa, NULL) < 0) {
              perror("cannot ignore SIGPIPE");
              return -1;
          }
  
          return UIApplicationMain(argc, argv, nil, NSStringFromClass([AppDelegate class]));
      }
  }
  

• Swift: AppDelegate.swift

  let handler: @convention(c) (Int32) -> () = { sig in
          // handle the signal somehow
          print("error", sig)
      }
  
  func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
          // Override point for customization after application launch.
  
          signal(SIGPIPE, handler)
          return true
      }
  

Enable the debug mode

During the development, you can enable the debug mode and print logs for troubleshooting.

• Objective-C:

  #ifdef DEBUG
      [[ThingSmartSDK sharedInstance] setDebugMode:YES];
      [[ThingSmartCameraSDK sharedInstance] setDebugMode:YES];
  #else
  #endif
  

• Swift:

  #if DEBUG
  ThingSmartSDK.sharedInstance()?.debugMode = true
  ThingSmartCameraSDK.sharedInstance()?.debugMode = true
  #else
  #endif
  

  During the development, we recommend that you use a real device for debugging. If a simulator is used for debugging, certain features might be unavailable.

Run the demo app

Cube App SDK demo app supports the IPC features. Follow the instructions in the Cube App SDK demo app, and configure the values of BundleId, AppKey, and AppSecret.

The demo app supports the following IPC features:

• Live streaming: P2P connections of IPCs, live video playing, video recording, screenshot capturing, video talks, and more.
• Playback: retrieval and playback of video footage from an SD card, and use of timeline components.
• Cloud Storage for Videos: service subscription, status query, and retrieval and playback of cloud-stored videos and cloud storage events.
• Messages: retrieval and display of alerts.
• Settings: use of standard data points for IPCs.