DJI Mobile SDK Documentation

      class DJIPanoramaMissionOperator

      @interface DJIPanoramaMissionOperator : NSObject
      Header:DJIPanoramaMissionOperator.h
      Inherits From:NSObject
      Description:

      The panorama mission operator is the only object that controls, runs and monitors Panorama Missions. It can be accessed from DJIMissionControl.

      Class Members:
      Current State
      property
      property currentState
      @property(nonatomic, readonly) DJIPanoramaMissionState currentState
      Header:DJIPanoramaMissionOperator.h
      Description:

      The current state of the operator.

      See Also:

      DJIPanoramaMissionState

      method addListenerToEvents:withQueue:andBlock
      -(void)addListenerToEvents:(id)listener
      withQueue:(nullable dispatch_queue_t)queue
      andBlock:(DJIPanoramaMissionOperatorEventBlock)block
      Header:DJIPanoramaMissionOperator.h
      Description:

      Adds listener to receive all events of the Panorama mission operator.

      Input Parameters:
      id listenerListener that is interested in Panorama mission operator.
      nullable dispatch_queue_t queueThe dispatch queue that block will be called on.
      DJIPanoramaMissionOperatorEventBlock blockBlock will be called when there is event updated.
      Remove Listener
      method
      method removeListener
      - (void)removeListener:(id)listener
      Header:DJIPanoramaMissionOperator.h
      Description:

      Removes listener. The listener will not receive any update after calling this method.

      Input Parameters:
      id listenerListener to be removed.
      method removeAllListeners
      - (void)removeAllListeners
      Header:DJIPanoramaMissionOperator.h
      Description:

      Remove all listeners.

      Setup Mission
      method
      method setupWithMode:withCompletion
      - (void)setupWithMode:(DJIPanoramaMode)mode withCompletion:(DJICompletionBlock)completion
      Header:DJIPanoramaMissionOperator.h
      Description:

      Sets up the Panorama mission with the specific mode. It can only be called when the currentState is one of the following:

      If the setup starts successfully, currentState will become DJIPanoramaMissionStateSettingUp. Normally, it will take seconds to complete the setup. Once setup is completed successfully, currentState will become DJIPanoramaMissionStateReadyToExecute.

      Input Parameters:
      DJIPanoramaMode modeAn enum value of DJIPanoramaMode.
      DJICompletionBlock completionCompletion block that will be called when the operator succeeds or fails to start the setup. If it fails, an error will be returned.
      Start Mission
      method
      method startMissionWithCompletion
      - (void)startMissionWithCompletion:(DJICompletionBlock)completion
      Header:DJIPanoramaMissionOperator.h
      Description:

      Starts to execute the mission that has been setup.
      It can only be called when the currentState is DJIPanoramaMissionStateReadyToExecute.
      If the mission is started successfully, the currentState will become DJIPanoramaMissionStateExecuting.

      Input Parameters:
      DJICompletionBlock completionCompletion block that will be called when the operator succeeds or fails to start the execution. If it fails, an error will be returned.
      Stop Mission
      method
      method stopMissionWithCompletion
      - (void)stopMissionWithCompletion:(DJICompletionBlock)completion
      Header:DJIPanoramaMissionOperator.h
      Description:

      Stops the executing mission. It can only be called when the currentState is DJIPanoramaMissionStateExecuting. After a mission is stopped successfully, currentState will become DJIPanoramaMissionStateReadyToExecute.

      Input Parameters:
      DJICompletionBlock completionCompletion block that will be called when the operator succeeds or fails to stop the mission. If it fails, an error will be returned.
      method getRecentPanoramaMediaFileWithCompletion
      -(void) getRecentPanoramaMediaFileWithCompletion:(void(^)(DJIMediaFile* _Nullable panoMedia, NSError* _Nullable error))completion
      Header:DJIPanoramaMissionOperator.h
      Description:

      Retrieves the DJIMediaFile object for the recently finished panorama mission.

      Input Parameters:
      DJIMediaFile* _Nullable panoMediaA DJIMediaFile file.
      NSError* _Nullable errorError retrieving the value.
      void(^)(DJIMediaFile* _Nullable panoMedia, NSError* _Nullable error) completionCompletion block that receives the execution result.
      typedef block DJIPanoramaMissionOperatorEventBlock
      typedef void (^DJIPanoramaMissionOperatorEventBlock)(DJIPanoramaMissionEvent *event)
      Header:DJIPanoramaMissionOperator.h
      Description:

      Block to receive the Panorama mission operator event.

      Input Parameters:
      DJIPanoramaMissionEvent * eventThe Panorama mission operator event with the state change.
      enum DJIPanoramaMissionState
      typedef NS_ENUM(NSInteger, DJIPanoramaMissionState)
      Header:DJIPanoramaMissionOperator.h
      Description:

      Panorama Mission State.

      Enum Members:
      DJIPanoramaMissionStateUnknownThe state of the operator is unknown. This is the initial state when the operator has just been created.
      DJIPanoramaMissionStateDisconnectedThe connection between the mobile device and Osmo is broken.
      DJIPanoramaMissionStateNotSupportedThe connected product does not support Panorama mission.
      DJIPanoramaMissionStateReadyToSetupThe operator is ready to setup a Panorama mission.
      DJIPanoramaMissionStateSettingUpThe operator is setting up for a Panorama mission.
      DJIPanoramaMissionStateReadyToExecuteThe setup for the Panorama mission is complete. The operator is ready to start the execution.
      DJIPanoramaMissionStateExecutingThe operator is executing a Panorama mission.
      enum DJIPanoramaMode
      typedef NS_ENUM (NSUInteger, DJIPanoramaMode)
      Header:DJIPanoramaMissionTypes.h
      Description:

      Defines options for different types of modes for Panorama mission.

      Enum Members:
      DJIPanoramaModeFullCircle360 Degree Panorama mode.
      DJIPanoramaModeHalfCircle180 Degree Panorama mode. Also known as selfie mode.
      DJIPanoramaModeUnknownUnknown mode.