Device Configuration and Update

Pre-requisite: The user has to be signed in to perform the following operations.

Update Device Information

To update the device information, The following method can be used:

device (required): The device object on which the operation has to be performed.
request (required): The request object containing the updated device information.

val request = UpdateDeviceRequest(
  name = "New Device Name", // The new name of the device
  location = "New Location", // The new location of the device
  // all fields optional; pairingStatus and operator can be set the same way
)
InstaVision.deviceServices.updateDeviceInfo(
  device = device,
  request = request,
  onSuccess = { device ->
    // The updated device object
  },
  onError = { error ->
    // The error object contains the error code and message
  },
)

Update Device Settings

To update the device settings, The following method can be used:

device (required): The device object on which the operation has to be performed.
deviceSetting (required): The request object containing the updated device settings.

val request = UpdateDeviceSettingRequest(
  isInPrivacyMode = true, // The new privacy mode status
)
InstaVision.deviceServices.updateDeviceSetting(
  device = device,
  deviceSetting = request,
  onSuccess = { deviceSetting ->
    // The updated device settings object
  },
  onError = { error ->
    // The error object contains the error code and message
  },
)

Toggle Device Light Mode

To switch the camera light on or off, The following method can be used. To change the light mode (LightMode: Intel, IR, CLR, Off) use updateDeviceSetting(lightMode = …) or the CameraLightLightMode cluster attribute.

device (required): The device object on which the operation has to be performed.
isOn (required): true to switch the light on, false to switch it off.

InstaVision.deviceServices.updateDeviceLightMode(
  device = device,
  isOn = true,
  onSuccess = { deviceSetting ->
    // The updated device settings object
  },
  onError = { error ->
    // The error object contains the error code and message
  },
)

Product-specific settings

Setting	Documented under
Camera GPS location	Trail → GPS Location
Hunting / embargo mode	Trail → Hunting / Embargo Mode
Lullaby player	Baby → Lullaby