This class contains interfaces related to the hand controller of a handheld device (such as Osmo). This object is available from the HandHeld subclass off BaseProduct.
The power mode to set. CAUTION! When the mode is OFF, the handheld product will be shut down and the connection will be broken. The user must then power on the device manually.
@Nullable final CompletionCallback callback
The execution callback with the execution result returned.
Enables/disables the gimbal control with the joystick. By default, it is enabled. The handheld will be reset to the default value when it reboots or SDK reinitializes. When gimbal control is disabled, the joystick can be used for other purposes in an SDK application by reading its position values with StickVerticalDirection and StickHorizontalDirection. Only supported in firmware version 1.2.0.40 or above.
Input Parameters:
boolean enabled
true to enable the gimbal control.
@Nullable CompletionCallback callback
The execution callback with the execution result returned.
The handheld product is awake. For Osmo, when it is in this mode, all the components in HandHeld are accessible.
SLEEPING
The handheld product is sleeping. The handheld controller keeps the wireless connection to the mobile device alive but most other components are off. The power consumption is low in this mode. For Osmo in this mode, only the HandheldController, AirLink, and Battery are accessible.
OFF
The handheld product is powered off. Once this mode is set the callback will receive this mode until the handheld device is shut down completely. It is not supported by Osmo Mobile.
The control mode for the gimbal physical controller (joystick for Osmo). The total controller deflection is a combination of horizontal and vertical deflection. This translates to gimbal movement around the yaw and pitch axes. The gimbal can be set to either move in both yaw and pitch simultaneously based on horizontal and vertical deflection of the controller, or move in only yaw or pitch exclusively based on whether horizontal or vertical deflection is larger.
Enum Members:
ONE_AXIS
Gimbal movement will be exclusively in yaw or pitch depending on whether the controller horizontal or vertical deflection is greater respectively.
TWO_AXIS
Gimbal movement will be in both yaw and pitch simultaneously relative to the horizontal and vertical deflection of the controller respectively.
Returns the component index. Index is zero based. A component will have an index greater than zero when there are multiple components of the same type on the DJI product, and one of the components already has the index 0. For instance, M210 can have two gimbal mounted cameras, and will therefore have two gimbal components with indices 0 and 1, and two camera components with indices 0 and 1. For Matrice 600, there are printed numbers on the battery boxes. The Battery component instance with index 0 corresponds to battery compartment number 1. For Inspire 2 and M200 series, Battery with index 0 corresponds to the battery on the port (left hand) side of the aircraft. For M210, M210 RTK, M300 RTK and M350 RTK, Camera and Gimbal with index 0 corresponds to the camera and gimbal on the port (left hand) side of the aircraft. Lidar with index 0 corresponds to the lidar(Zenmuse L1) on the port (left hand) side of the aircraft.
Gets the serial number of the component. Depending on the component, this serial number might not match the serial number found on the physical component.
Returns the firmware version of the component. Each component will have a different firmware version, the combination of which will form the package firmware version getFirmwarePackageVersion found in BaseProduct.
Input Parameters:
@NonNull CompletionCallbackWith<String> callback
The execution callback with the value(s) returned.