Device System Settings

Overview

Device system related settings, includes language, name, timezone etc.

Name

• Description

  - (void)setDeviceName:(NSString *)deviceName deviceID:(NSString *)UUID completionHandler:(LPSDKReturnBlock _Nullable)completionHandler;
  

• Parameter

• Response

  N/A

• Sample Code

  [[LPDeviceSettingsManager sharedInstance] setDeviceName:@"Music" deviceID:device.deviceStatus.UUID completionHandler:^(NSURLResponse * _Nullable response, id  _Nullable responseObject, NSError * _Nullable error) {
      if ([responseObject[@"result"] isEqualToString:@"OK"]) {
         NSLog(@"Set device name successfully");
      }
  }];
  

Restore

• Description

  - (void)resetDeviceWithHandler:(LPSDKReturnBlock _Nullable)completionHandler;
  

• Parameter

  N/A

• Response

  N/A

• Sample Code

  [device.deviceSettings resetDeviceWithHandler:^(NSURLResponse * _Nullable response, id  _Nullable responseObject, NSError * _Nullable error) {
      if ([responseObject[@"result"] isEqualToString:@"OK"]) {
         NSLog(@"Reset device successfully");
      }
  }];
  

Get current input mode

• Description

  Get current input mode of the device

  LPInputSource currentDeviceInputMode = device.deviceStatus.currentInputMode;
  

Get supported input sources

• Description

  Input Mode array supported by the device, the content is the number corresponding to the LPInputSource type

  - (NSArray *)getSupportInputSource;
  

• Parameter

  N/A

• Response

• Sample Code

  NSArray *inputModeArray = [device.deviceSettings getSupportInputSource];
  for (NSNumber *inputMode in inputModeArray) {
      LPInputSource source = [inputMode intValue];
      NSLog(@"Input source supported by the device: = %d", source);
  }
  

Switch input source

• Description

  Switch the input source of the device, such as Bluetooth, AUX, RCA

  - (void)switchInputSource:(LPInputSource)source  completionHandler:(LPSDKReturnBlock _Nullable)completionHandler;
  

• Parameter

• Response

  N/A

• Sample Code

  LPInputSource *sourc = LPBluetooth;
  [device.deviceSettings switchInputSource:source completionHandler:^(NSURLResponse * _Nullable response, id  _Nullable responseObject, NSError * _Nullable error) {
      if ([responseObject[@"result"] isEqualToString:@"OK"]) {
          LPInputSource source = device.deviceStatus.currentInputMode;
          NSLog(@"Switch deivce input source successfully");
      }
  }];
  

Network detection

• Description

  Judge if the device has a network, if the device network changes, it will trigger the notification LPInternetAccessChange, at this time the value of isHaveInternet has been updated.

  // LPDeviceStatus
  @property (nonatomic, assign) BOOL isHaveInternet;
  

• Sample Code

  if (device.deviceStatus.isHaveInternet) {
      NSLog(@"Device has a network");
  }else {
      NSLog(@"Device has no network");
  }
  

  // NSNotification
  [[NSNotificationCenter defaultCenter] addObserver:self selector:@selector(internetAccessChange:) name:@"LPInternetAccessChange" object:nil];
  
  - (void)internetAccessChange:(NSNotification *)notification {
      NSDictionary *infoDict = notification.object;
      NSLog(@"UUID = %@ isHaveInternet = %@", infoDict[@"UUID"], infoDict[@"isHaveInternet"]);
  }
  

EQ

Get EQ

• Description

  Get the supported EQ type and current Value. After modifying the value of EQ in other ways, you can synchronize the Value through the LPEQValueChangeNotification notification The data structure is as follows:

  {
      "Mode":"POP",
      "Version":1,
      "EQValue": @[
          @{@"Name":@"BandBASS", @"Value":@"0"},
          @{@"Name":@"BandLOW", @"Value":@"0"},
          @{@"Name":@"BandMID", @"Value":@"0"},
          @{@"Name":@"BandHIGH", @"Value":@"0"},
          @{@"Name":@"BandTREBLE", @"Value":@"0"}
          ...
      ]
  }
  

  The array corresponding to the EQValue field is a collection of EQ types supported by the device. If there is a special EQ type, please contact Linkplay firmware personnel to configure the server data parameters. Generally, the value of Value is -5 to 5, please make sure that the value of Value is of type int.

  - (void)getSupportEQAndValues:(LPSDKReturnBlock _Nullable)completionHandler;
  

• Parameter

  N/A

• Response

  N/A

• Sample Code

  [device.deviceSettings getSupportEQAndValues:^(NSURLResponse * _Nullable response, id  _Nullable responseObject, NSError * _Nullable error) {
      if (responseObject) {
          NSLog(@"SupportEQ = %@", responseObject[@"EQValue"]);
      }
  }];
  

Set EQ

• Description

  Set the value of each EQ type

  - (void)setEQValues:(NSDictionary *)valuesDict completionHandler:(LPSDKReturnBlock _Nullable)completionHandler;
  

• Parameter

• Response

  N/A

• Sample Code

  //valuesArray: the device supported EQ types
  NSArray *valuesArray = @[@{@"Name":@"BandBASS", @"Value":@"-5"} ,@{@"Name":@"BandLOW", @"Value":@"-2"},@{@"Name":@"BandMID", @"Value":@"0"},@{@"Name":@"BandHIGH", @"Value":@"2"},@{@"Name":@"BandTREBLE", @"Value":@"5"}];
  NSDictionary *EQValuesDict = @{@"EQValue":valuesArray};
  [device.deviceSettings setEQValues:EQValuesDict completionHandler:^(NSURLResponse * _Nullable response, id  _Nullable responseObject, NSError * _Nullable error) {
      NSLog(@"EQValue = %@", responseObject[@"EQValue"]);
  }];
  

EQ NSNotification

• NSNotification description

  When the EQ is adjusted through settings or other mobile phones, this notification will be triggered to update the data synchronously

  LPEQValueChangeNotification

• Sample Code

  [[NSNotificationCenter defaultCenter] addObserver:self selector:@selector(EQValueChangeNotification:) name:@"LPEQValueChangeNotification" object:nil];
  
  - (void)EQValueChangeNotification:(NSNotification *)notification {
      NSDictionary *infoDict = notification.object;
      if ([[infoDict allKeys] containsObject:@"EQValue"]) {
          NSLog(@"EQValue = %@", infoDict[@"EQValue"]);
      }
  }
  

SSID and password

Hide/Open SSID

• Description

  Hide or open the SSID of the device. When you turn on the device SSID, if there is no password, it is best to prompt the user to set the password. You can judge whether the SSID has been hidden according to the isSSIDHidden attribute in deviceStatus

  - (void)hideSSID:(BOOL)hide completionHandler:(LPSDKReturnBlock _Nullable)completionHandler;
  

• Parameter

• Response

  N/A

• Sample Code

   // Open the device SSID
   BOOL isHidden = device.deviceStatus.isSSIDHidden;
  [device.deviceSettings hideSSID:NO completionHandler:^(NSURLResponse * _Nullable response, id  _Nullable responseObject, NSError * _Nullable error) {
      if ([responseObject[@"result"] isEqualToString:@"OK"]) {
          // Open the device SSID successfully
          // If the device SSID has not set a password, you need to prompt the user to set a password
          if (device.deviceStatus.password.length == 0) {
              [device.deviceSettings setSSIDPassword:@"12345678" completionHandler:^(NSURLResponse * _Nullable response, id  _Nullable responseObject, NSError * _Nullable error) {
                  if ([responseObject[@"result"] isEqualToString:@"OK"]) {
                      NSLog(@"Successfully set the SSID password");
                  }else {
                      NSLog(@"Failed to set SSID password");
                      // Hide device SSID again
                      [device.deviceSettings hideSSID:YES completionHandler:^(NSURLResponse * _Nullable response, id  _Nullable responseObject, NSError * _Nullable error) {
  
                      }];
                  }
              }];
          }else {
              NSLog(@"Choose whether to reset the password");
          }
      }else {
          NSLog(@"Failed to open device SSID");
      }
  }];
  
  // Hide the device SSID
  [device.deviceSettings hideSSID:YES completionHandler:^(NSURLResponse * _Nullable response, id  _Nullable responseObject, NSError * _Nullable error) {
      if ([responseObject[@"result"] isEqualToString:@"OK"]) {
          NSLog(@"Device SSID is turned off");
      }else {
          NSLog(@"Device SSID turned off failed");
      }
  }];
  

Set SSID password

• Description

  Set the device SSID password, please note that the password length is at least 8 digits.

  - (void)setSSIDPassword:(NSString *)password completionHandler:(LPSDKReturnBlock _Nullable)completionHandler;
  

• Parameter

• Response

  N/A

• Sample Code

   // Set SSID password
  [device.deviceSettings setSSIDPassword:@"12345678" completionHandler:^(NSURLResponse * _Nullable response, id  _Nullable responseObject, NSError * _Nullable error) {
      if ([responseObject[@"result"] isEqualToString:@"OK"]) {
          NSLog(@"Successfully set the SSID password");
      }else {
          NSLog(@"Failed to set SSID password");
      }
  }];