class HandHeld
class HandHeld extends BaseProduct
Description:
Handheld product class, which includes basic product information and access to all components (such as camera, battery etc.). This object is accessed from getProduct
in DJISDKManager
.
Class Members:
method getHandHeldController
HandheldController getHandHeldController ()
Description:
Returns an instance of the handheld device's handheld controller.
Return:
Inherited Methods:
dji.sdk.base.BaseProduct
method
method setDiagnosticsInformationCallback
void setDiagnosticsInformationCallback (DiagnosticsInformationCallback callback)
Description:
Sets up the diagnostics list update callback.
method getFirmwarePackageVersion
String getFirmwarePackageVersion ()
Description:
Gets the product's firmware package version. Products other than Phantom 4, Phantom 4 Pro, Mavic Pro, and Inspire 2, require internet connection. The execution time for this method depends on the speed of internet connectivity.
Return:
String The product's firmware package version string.
method setName
void setName (@NonNull String name, @Nullable final CommonCallbacks.CompletionCallback callback)
Description:
Retrieves the model of the product.
@NonNull String name Name to be set to the aircraft. @Nullable final CommonCallbacks .CompletionCallback callback Asynchronous execution result.
method getName
void getName (final CommonCallbacks.CompletionCallbackWith<String> callback)
Description:
Retrieves the model of the product.
final CommonCallbacks .CompletionCallbackWith<String> callback The execution callback with the returned value.
method getModel
Description:
Retrieves the model of the product. See Aircraft
and HandHeld
for the possible strings that can be returned.
Return:
Model The model of the product.
method isConnected
Description:
true
if the device is connected.
Return:
boolean true
if the device is connected.
method getCamera
Description:
Retrieves an instance of the device's camera. Only supported by the product with single gimbal, except Zenmuse XT2 and Mavic 2 Enterprise Camera.
Return:
Camera An instance of the aircraft's camera.
method getBattery
Description:
Retrieves an instance of the product's smart battery. When using products with multiple batteries, such as the M600 or Inspire 2, use getBatteries
, as this method will only return a single battery.
Return:
Battery An instance of the aircraft's smart battery.
method getBatteries
synchronized List<Battery> getBatteries ()
Description:
Returns an array of aircraft's batteries. It is used when the aircraft has multiple batteries, e.g. Matrice 600.
Return:
synchronized List<Battery> A List of Battery
objects.
method getGimbal
Description:
Retrieves an instance of the device's gimbal.
Return:
Gimbal An instance of the aircraft's gimbal.
method getAirLink
Description:
Retrieves an instance of the device's AirLink.
Return:
AirLink An instance of the aircraft's AirLink.
method getAccessoryAggregation
@Nullable AccessoryAggregation getAccessoryAggregation ()
Description:
Retrieves an instance of the accessory aggregation.
Return:
AccessoryAggregation 'NULL' if the product does not support accessories (e.g. spotlight, speaker or beacon).