Sets the channel selection mode. Both channel number and bandwidth can be changed. If the 5 GHz band is available, then channels from that band can also be used.
Sets the channel bandwidth of the OcuSync link. It can be set only when the selection mode is MANUAL. For Mavic Air 2, DJI Air 2S, only supported bandwidth with 20MB.
Selects the channel number. The OcuSync link operates on a 10 MHz or 20 MHz channel between 2400.5 MHz and 2482.5 MHz. The channel can be centered at 1 MHz steps within the band. Therefore for a 10 MHz bandwidth, the OcuSync channel can be centered at 2405.5 MHz, 2406.5 MHz and every 1 MHz to 2477.5 MHz. For a 20 MHz bandwidth, channel center can be at 2410.5 MHz to 2472.5 MHz in 1 MHz steps. The channel location within the band is specified using the Channel Number. Channel Number is defined as the integer of 0.5 MHz less than the channel center frequency. E.g. Channel Number 2406 represents the 10 MHz channel centered at 2406.5 MHz (this is only for the 10 MHz bandwidth as 20 MHz bandwidth channels start at 2410.5 MHz). Channel Number 2450 represents the channel centered at 2450.5 MHz (of any bandwidth). Use getChannelNumberValidRange to check the valid Channel Numbers for a given bandwidth. Channel Number can only be set when the channel selection mode is MANUAL.
Gets the current OcuSync Link Channel Number. The OcuSync link operates on a 10 MHz or 20 MHz channel between 2400.5 MHz and 2482.5 MHz. The channel can be centered at 1 MHz steps within the band. Therefore for a 10 MHz bandwidth, the OcuSync channel can be centered at 2405.5 MHz, 2406.5 MHz and every 1 MHz to 2477.5 MHz. For a 20 MHz bandwidth, channel center can be at 2410.5 MHz to 2472.5 MHz in 1 MHz steps. The channel location within the band is specified using the Channel Number. Channel Number is defined as the integer of 0.5 MHz less than the channel center frequency. E.g. Channel Number 2406 represents the 10 MHz channel centered at 2406.5 MHz (this is only for the 10 MHz bandwidth as 20 MHz bandwidth channels start at 2410.5 MHz). Channel Number 2450 represents the channel centered at 2450.5 MHz (of any bandwidth).
Gets the valid range of Channel Numbers. The OcuSync link operates on a 10 MHz or 20 MHz channel between 2400.5 MHz and 2482.5 MHz. The channel can be centered at 1 MHz steps within the band. Therefore for a 10 MHz bandwidth, the OcuSync channel can be centered at 2405.5 MHz, 2406.5 MHz and every 1 MHz to 2477.5 MHz. For a 20 MHz bandwidth, channel center can be at 2410.5 MHz to 2472.5 MHz in 1 MHz steps. The channel location within the band is specified using the Channel Number. Channel Number is defined as the integer of 0.5 MHz less than the channel center frequency. E.g. Channel Number 2406 represents the 10 MHz channel centered at 2406.5 MHz (this is only for the 10 MHz bandwidth as 20 MHz bandwidth channels start at 2410.5 MHz). Channel Number 2450 represents the channel centered at 2450.5 MHz (of any bandwidth). This method should be used to confirm the Channel Number to be set with setChannelNumber is valid.
Input Parameters:
final CompletionCallbackWith<Integer[]> callback
The execution callback with the returned value(s).
Gets the frequency bands supported by the product in the current area. It is supported by P4P V2 and Mavic 2 Series. For Mavic Pro, only 2.4GHz is supported.
voidsetFrequencyBand(OcuSyncFrequencyBand frequencyBand, final CompletionCallback callback)
Package:
dji.sdk.airlink
Description:
Sets the OcuSync air link frequency band. It is only supported by Phantom 4 Pro V2 and Mavic 2 Series. For Mavic Pro, the frequency band is always 2.4 GHz. Not supported by Mavic Air 2.
Gets the OcuSync air link frequency band. It is only supported by Phantom 4 Pro V2 and Mavic 2 Series. For Mavic Pro, the frequency band is always 2.4 GHz.
voidsetBandwidthAllocationForPrimaryVideo(@FloatRange(from = 0.0f, to = 1.0f)float percent, @Nullable final CommonCallbacks.CompletionCallback callback)
Package:
dji.sdk.airlink
Description:
Sets the percentage of the primary video bandwidth. The remaining percentage is dedicated to the secondary video. The primary source can only be LEFT_CAM or RIGHT_CAM. The secondary source can be LEFT_CAM, RIGHT_CAM and FPV_CAM. It is only supported by M200 series v2.
Input Parameters:
@FloatRange(from = 0.0f, to = 1.0f) float percent
Percentage downlink bandwidth for the primary video feed.
voidgetBandwidthAllocationForPrimaryVideo(@NonNull final CommonCallbacks.CompletionCallbackWith<Float> callback)
Package:
dji.sdk.airlink
Description:
When a product has multiple main cameras, this method gets the percentage bandwidth allocation dedicated to the primary video. The remaining percentage is dedicated to the secondary video. It is only supported by M200 series v2.
Input Parameters:
@NonNull final CommonCallbacks.CompletionCallbackWith<Float> callback
The execution callback with the value(s) returned.
voidassignSourceToPrimaryChannel(PhysicalSource primarySource, PhysicalSource secondarySource, @Nullable final CommonCallbacks.CompletionCallback callback)
Package:
dji.sdk.airlink
Description:
Assign the primary video and the secondary video source. It can be supported by M200 series V2 and Matrice 300 RTK. On M200 series v2, the primary source only can be LEFT_CAM or FPV_CAM. The secondary source can be LEFT_CAM, RIGHT_CAM and FPV_CAM. On Matrice 300 RTK, both primary and secondary sources can be LEFT_CAM, RIGHT_CAM, TOP_CAM and FPV_CAM, if you just want to use one video source , you should set the secondary souce with UNKNOWN.
Warning that interference is high for take-off. When the signal gets weaker as separation between remote controller and aircraft get larger, there is a change the link will fail.
STRONG_DOWN_LINK_INTERFERENCE
There is strong interference on the downlink signal incident on the remote controller. If the channel selection mode MANUAL is being used, consider changing to AUTO as the OcuSync link can automatically select Channel Numbers and bandwidth to mitigate interference on the fly.
STRONG_UP_LINK_INTERFERENCE
There is strong interference on the uplink signal incident on the aircraft.
WEAK_SIGNAL
Weak OcuSync signal strength. Be aware of anything blocking the signal between the remote controller and aircraft, adjust the orientation of the antennas on the remote controller, or reduce the distance between remote controller and aircraft to increase signal strength.
AIRCRAFT_LINK_REBOOT
The OcuSync link on the aircraft is rebooting.
UP_LINK_BROKEN
The uplink from the remote controller to the aircraft is broken. Usually if only the uplink disconnects, it is due to interference on the aircraft's OcuSync antennas. Try changing the channel number if the interference source cannot be removed.
DOWN_LINK_BROKEN
The downlink from the aircraft to the remote controller is broken. Usually if only the downlink disconnects, it is due to interference on the remote controller's OcuSync antennas. Try changing channel number, or reducing the bandwidth of the channel to make it more robust.
LINK_UNUSABLE
The link between the remote controller and the aircraft is unusable. It is determined to be unusable if signal is too weak. Check to see if the antennas are setup correctly and the path from remote controller to aircraft is unobstructed.
The channel bandwidth for the OcuSync downlink (from the aircraft to the remote controller). Setting a smaller bandwidth will reduce the data rate, but make the connection more robust.
Enum Members:
Bandwidth20MHz
The frequency band of the OcuSync link is 20 MHz (up to 46 Mbps).
Bandwidth10MHz
The frequency band of the OcuSync link is 10 MHz (up to 23 Mbps).
Bandwidth40MHZ
The frequency band of the OcuSync link is 40 MHz (up to 80 Mbps). Only supported by Matrice 300 RTK.