class DJIRTKNetworkServiceProvider

@interface DJIRTKNetworkServiceProvider : NSObject

Header:	DJIRTKNetworkServiceProvider.h
Inherits From:	`NSObject`

Description:

This class is used to control the RTK network service. The DJIRTKNetworkServiceProvider can initiate the communication to a third-party RTK network server. The information from the server can be streamed to the RTK airsystem. SDK will not cache the settings to the disk. The provider should be configured in each life cycle of SDK. The life cycle of the network service provider is independent from the aircraft. Therefore, it can be configured before connecting to DJI aircrafts. It is only supported by Phantom 4 RTK, P4 Multispectral, Mavic 2 Enterprse Advanced, Matrice 210 RTK V2 and Matrice 300 RTK.

Class Members:

Set Network Service Settings

method

setNetworkServiceSettings

method setNetworkServiceSettings

- (void)setNetworkServiceSettings:(DJIRTKNetworkServiceSettings *)settings

Header:

DJIRTKNetworkServiceProvider.h

Description:

Sets the configuration for the network service that provides network reference stations. The network service should use NTRIP (Networked Transport of RTCM via Internet Protocol).

Input Parameters:

DJIRTKNetworkServiceSettings * settings

The configuration to set.

method

networkServiceSettings

method networkServiceSettings

- (DJIRTKNetworkServiceSettings *_Nullable)networkServiceSettings

Header:

DJIRTKNetworkServiceProvider.h

Description:

Gets the configuration for the network service that provides network reference stations. The network service should use NTRIP(Networked Transport of RTCM via Internet Protocol).

Return:

DJIRTKNetworkServiceSettings *_Nullable An instance of DJIRTKNetworkServiceSettings.

Start Network Service

method

startNetworkServiceWithCompletion

method startNetworkServiceWithCompletion

- (void)startNetworkServiceWithCompletion:(DJICompletionBlock)completion

Header:

DJIRTKNetworkServiceProvider.h

Description:

Starts the network service as the reference station. This should be called after setting the network service (setNetworkServiceSettings).

Input Parameters:

DJICompletionBlock completion

The completion block that receives the result.

Start Network Service With Param

method

startNetworkServiceWithCoordinateSystem:WithCompletion

method startNetworkServiceWithCoordinateSystem:WithCompletion

- (void)startNetworkServiceWithCoordinateSystem:(DJIRTKNetworkServiceCoordinateSystem)coordinateSystem WithCompletion:(DJICompletionBlock)completion

Header:

DJIRTKNetworkServiceProvider.h

Description:

Starts the network service as the reference station. This should be called after setting the network service (setNetworkServiceSettings).

Input Parameters:

DJIRTKNetworkServiceCoordinateSystem coordinateSystem	The coordinateSystem to set when init rtk service
DJICompletionBlock completion	The completion block that receives the result.

Stop Network Service

method

stopNetworkServiceWithCompletion

method stopNetworkServiceWithCompletion

- (void)stopNetworkServiceWithCompletion:(DJICompletionBlock)completion

Header:

DJIRTKNetworkServiceProvider.h

Description:

Stops the network service.

Input Parameters:

DJICompletionBlock completion

The completion block that receives the result.

Current State

property

currentState

property currentState

@property (nonatomic, readonly) DJIRTKNetworkServiceState *currentState

Header:

DJIRTKNetworkServiceProvider.h

Description:

The current network service state.

Description:

Adds a listener to receive the latest network service state.

Input Parameters:

id listener	Listener to receive network service state. It is used to distinguish different listener and the listener will be retained.
nullable dispatch_queue_t queue	The dispatch queue to process state. The main queue is used if it is `nil`.
DJIRTKNetworkServiceStateBlock block	The block that process the latest state.

Remove Network Service State Listener

method

removeNetworkServiceStateListener

method removeNetworkServiceStateListener

- (void)removeNetworkServiceStateListener:(id)listener

Header:

DJIRTKNetworkServiceProvider.h

Description:

Removes a listener that is added by passing to addNetworkServiceStateListener:queue:block.

Input Parameters:

id listener

The listener to remove.

Current Coordinate System

method

currentNetworkServiceCoordinateSystem

method currentNetworkServiceCoordinateSystem

- (DJIRTKNetworkServiceCoordinateSystem)currentNetworkServiceCoordinateSystem

Header:

DJIRTKNetworkServiceProvider.h

Description:

Gets current network RTK coordinate system.

Return:

DJIRTKNetworkServiceCoordinateSystem Current DJIRTKNetworkServiceCoordinateSystem.

Set Coordinate System

method

setNetworkServiceCoordinateSystem:completion

method setNetworkServiceCoordinateSystem:completion

- (void)setNetworkServiceCoordinateSystem:(DJIRTKNetworkServiceCoordinateSystem)coordinateSystem completion:(DJICompletionBlock)completion

Header:

DJIRTKNetworkServiceProvider.h

Description:

Sets coordinate system for rtk network service. Only can be used when current DJIRTKReferenceStationSource is DJIRTKReferenceStationSourceNetworkRTK, and please make sure the channelState is DJIRTKNetworkServiceChannelStateTransmitting.

Input Parameters:

DJIRTKNetworkServiceCoordinateSystem coordinateSystem	The `DJIRTK_DJIRTKNetworkServiceCoordinateSystem` to set.
DJICompletionBlock completion	The completion block that receives the result.

Activate Network Service

method

activateNetworkServiceWithPlanType:completion

method activateNetworkServiceWithPlanType:completion

- (void)activateNetworkServiceWithPlanType:(DJIRTKNetworkServicePlanType)type completion:(DJICompletionBlock)completion

Header:

DJIRTKNetworkServiceProvider.h

Description:

Activates network RTK activateNetworkServiceWithPlanType:completion.

Input Parameters:

DJIRTKNetworkServicePlanType type	Enum of `DJIRTKNetworkServicePlanType`.
DJICompletionBlock completion	The completion block that receives the result.

Order Plans

method

getNetworkServiceOrderPlansWithCompletion

method getNetworkServiceOrderPlansWithCompletion

- (void)getNetworkServiceOrderPlansWithCompletion:(void(^)(DJIRTKNetworkServicePlansState *_Nullable plans, NSError *_Nullable error))completion

Header:

DJIRTKNetworkServiceProvider.h

Description:

Gets network service plans.

Input Parameters:

DJIRTKNetworkServicePlansState *_Nullable plans	The value of the `DJIRTKNetworkServicePlansState`.
NSError *_Nullable error	Error retrieving the value.
void(^)(DJIRTKNetworkServicePlansState _Nullable plans, NSError _Nullable error) completion	Completion block to receive the result.

enum

DJIRTKNetworkServiceChannelState

enum DJIRTKNetworkServiceChannelState

typedef NS_ENUM(uint8_t, DJIRTKNetworkServiceChannelState)

Header:

DJIRTKServcieBaseTypes.h

Description:

All the possible state of DJIRTKNetworkServiceChannelState.

Enum Members:

DJIRTKNetworkServiceChannelStateDisabled	The network service is not started.
DJIRTKNetworkServiceChannelStateNetworkNotReachable	The network is not reachable from the mobile device.
DJIRTKNetworkServiceChannelStateAircraftDisconnected	The aircraft is not connected.
DJIRTKNetworkServiceChannelStateLoginFailure	SDK cannot login with the provided username and password. Check `error`.
DJIRTKNetworkServiceChannelStateReady	The channel from the server to the aircraft is built up. It is ready for transmission.
DJIRTKNetworkServiceChannelStateTransmitting	Data is transmitting through the channel.
DJIRTKNetworkServiceChannelStateDisconnected	The channel is disconnected and the server is not reachable now. Check `error`.
DJIRTKNetworkServiceChannelStateAccountError	User account error. Check `error`.
DJIRTKNetworkServiceChannelStateServerNotReachable	Unable to connect to server.
DJIRTKNetworkServiceChannelStateConnecting	Connecting to server.
DJIRTKNetworkServiceChannelStateServiceSuspension	The account for network RTK plan A has been expired, please activate plan B.
DJIRTKNetworkServiceChannelStateInvalidRequest	The invalid request is rejected by the server.
DJIRTKNetworkServiceChannelStateUnknown	Unknown.

class

DJIRTKNetworkServiceState

class

DJIRTKNetworkServicePlan

class

DJIRTKNetworkServicePlansState

typedef block

DJIRTKNetworkServiceStateBlock

typedef block DJIRTKNetworkServiceStateBlock

typedef void (^_Nullable DJIRTKNetworkServiceStateBlock) (DJIRTKNetworkServiceState *state)

Header:

DJIRTKNetworkServiceProvider.h

Description:

Block that receive the network service state.

Input Parameters:

DJIRTKNetworkServiceState * state

The network service state.

class

DJIRTKNetworkServiceSettings

class

DJIMutableRTKNetworkServiceSettings

Mobile SDK

class DJIRTKNetworkServiceProvider

Description:

Class Members:

method setNetworkServiceSettings

Description:

Input Parameters:

method networkServiceSettings

Description:

Return:

method startNetworkServiceWithCompletion

Description:

Input Parameters:

method startNetworkServiceWithCoordinateSystem:WithCompletion

Description:

Input Parameters:

method stopNetworkServiceWithCompletion

Description:

Input Parameters:

property currentState

Description:

See Also:

method addNetworkServiceStateListener:queue:block

Description:

Input Parameters:

method removeNetworkServiceStateListener

Description:

Input Parameters:

method currentNetworkServiceCoordinateSystem

Description:

Return:

method setNetworkServiceCoordinateSystem:completion

Description:

Input Parameters:

method activateNetworkServiceWithPlanType:completion

Description:

Input Parameters:

method getNetworkServiceOrderPlansWithCompletion

Description:

Input Parameters:

Related:

enum DJIRTKNetworkServiceChannelState

Description:

Enum Members:

typedef block DJIRTKNetworkServiceStateBlock

Description:

Input Parameters:

Search Mobile SDK Document

{{{(item.highlights && item.highlights.title) || item.title}}}