dji_mqtt_connect 0.1.35 → 0.1.35.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ace0900f4c5fcc4f197c50ef0fa71015bc8cedcce7d20c338f70f7e0189ca31d
-  data.tar.gz: f59f7cea3698db298d814a7d614806604cec33343eff46fb041c037447bdf632
+  metadata.gz: 6b1c329539ef66f69b2aa9fd3ca9c8a115766ac03070a44fb223736218996447
+  data.tar.gz: 3e42765a57d9a9e8cbd312583b9fed7f710ec3a32d552a58a72f59c04466faed
 SHA512:
-  metadata.gz: 3d4afe1b0e79f7bbec3909c6d3ebaf80e34c8a1097c4747ddfa2a86d6ee00982efed2289e1787a9ef69aa81a57a018d49cd432d73537b69f9318b010e8a64175
-  data.tar.gz: 9feadda48f150692bc6c52d88bcdb839a50a15100a0ea67904037acd17266fd05e77605ed2fb89533c1b540b81efa7ef54c2e24d91883662d511c4a04388e65e
+  metadata.gz: 5d705f19afffbe1bf734eb90e5a266d42192608c2700550abdbed685284b7ec1f48c3481c0100ebae02ade40a825ad858307e4f717de6be4dcc19e824fd6facd
+  data.tar.gz: 02ec49b14ffde6911c026e94b40061630a769b06155532c35cadcfeb5a8806ac158e05e58e52ece6cc17037eb8d808d090b1f84dd52cd455af9a8008b4706bb5

data/config/locales/thing_product_events.en.yml

@@ -2,12 +2,14 @@ en:
   dji_mqtt_connect:
     thing_product_events_summary:
       default: "Received %{method} event: %{result}"
+      camera_photo_take_progress: "Photo Capture Progress: %{status} (%{percent}%)"
       charge_close: "Stop Charging: %{status} (%{step_key} %{percent}%)"
       charge_open: "Start Charging: %{status} (%{step_key} %{percent}%)"
       cover_close: "Cover closing: %{status} (%{current_step}/%{total_steps} %{percent}%)"
       cover_force_close: "Force Cover Close: %{status} (%{current_step}/%{total_steps} %{percent}%)"
       cover_open: "Cover opening: %{status} (%{current_step}/%{total_steps} %{percent}%)"
       device_exit_homing_notify: "Device is exiting return to home: %{action} (%{reason})"
+      device_format: "Dock Data Formatting: %{status} (%{percent}%)"
       device_reboot: "Rebooting device: %{status} (%{current_step}/%{total_steps} %{percent}%)"
       drone_close: "Aircraft shutdown: %{status} (%{percent}%)"
       drone_open: "Aircraft Power-on: %{status}"

data/config/locales/thing_product_services.en.yml

@@ -13,6 +13,7 @@ en:
       flighttask_recovery: "Requesting resume for all Flights"
       flighttask_stop: "Requesting flight stop"
       flighttask_undo: "Requesting cancellation of flights"
+      live_camera_change: "Requesting live camera change: Video %{video_id} (Camera Position %{camera_position})"
       live_lens_change: "Requesting live lens change: %{video_type} (Video %{video_id})"
       live_set_quality: "Requesting live quality change: %{video_quality} (Video %{video_id})"
       live_start_push: "Requesting broadcast start: Video %{video_id}"

data/lib/dji_mqtt_connect/factories/events/camera_photo_take_progress.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+module DjiMqttConnect
+  module Factories::EventsMessages
+    def build_thing_product_camera_photo_take_progress_events_message
+      message_data = {
+        output: {
+          ext: {
+            camera_mode: 3
+          },
+          progress: {
+            current_step: 0,
+            percent: 100
+          },
+          status: "ok"
+        },
+        result: 0
+      }
+
+      Thing::Product::CameraPhotoTakeProgressEventsMessage.new(
+        bid: Message.generate_bid,
+        tid: Message.generate_tid,
+        timestamp: Message.current_timestamp,
+        gateway: "GATEWAYSN",
+        _method: "camera_photo_take_progress",
+        need_reply: 1,
+        data: message_data,
+        _data: message_data
+      )
+    end
+  end
+end

data/lib/dji_mqtt_connect/factories/events/device_format.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+module DjiMqttConnect
+  module Factories::EventsMessages
+    ### Device Format ###
+
+    def build_thing_product_device_format_events_message
+      message_data = {
+        result: 0,
+        output: {
+          status: "in_progress",
+          progress: {
+            percent: 80,
+            step_key: "xxx"
+          }
+        }
+      }
+
+      Thing::Product::DeviceFormatEventsMessage.new(
+        bid: Message.generate_bid,
+        tid: Message.generate_tid,
+        timestamp: Message.current_timestamp,
+        _method: "device_format",
+        need_reply: 1,
+        data: message_data,
+        _data: message_data
+      )
+    end
+  end
+end

data/lib/dji_mqtt_connect/factories/services_messages.rb

@@ -189,6 +189,15 @@ module DjiMqttConnect
 
     ### Live Stream (Services Messages) ###
 
+    def build_thing_product_live_camera_change_services_message
+      Thing::Product::LiveCameraChangeServicesMessage.build(
+        data: {
+          video_id: "1ZNDH1D0010098/165-0-7/normal-0",
+          camera_position: 0
+        }
+      )
+    end
+
     def build_thing_product_live_lens_change_services_message
       Thing::Product::LiveLensChangeServicesMessage.build(
         data: {

data/lib/dji_mqtt_connect/factories/services_reply/live_camera_change.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module DjiMqttConnect
+  module Factories
+    def build_thing_product_live_camera_change_services_reply_message
+      message_data = {result: 0}
+
+      Thing::Product::LiveCameraChangeServicesReplyMessage.new(
+        bid: Message.generate_bid,
+        tid: Message.generate_tid,
+        timestamp: Message.current_timestamp,
+        _method: "live_camera_change",
+        _data: message_data,
+        data: message_data
+      )
+    end
+  end
+end

data/lib/dji_mqtt_connect/factories.rb

@@ -620,3 +620,5 @@ module DjiMqttConnect
     end
   end
 end
+
+Dir[File.join(__dir__, "factories", "services_reply", "*.rb")].sort.each { |file| require file }

data/lib/dji_mqtt_connect/messages/thing/product/events/camera_photo_take_progress.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+module DjiMqttConnect
+  module Thing::Product
+    # Persistent progress updates for camera_photo_take (e.g. panorama or other persistent photo capturing).
+    # https://developer.dji.com/doc/cloud-api-tutorial/en/api-reference/dock-to-cloud/mqtt/dock/dock3/drc.html#upload-capture-progress
+    class CameraPhotoTakeProgressEventsMessage < EventsMessage
+      attribute :_method, Types::String.enum("camera_photo_take_progress")
+
+      attribute :data do
+        attribute :result, Types::ResultCode
+        include Mixins::ResultCode
+
+        attribute :output do
+          attribute :status, Types::ServicesOutputStatus
+
+          def humanized_status
+            I18n.t(status, scope: "dji_mqtt_connect.services_output_status", default: status.titleize)
+          end
+
+          attribute :progress do
+            # {"3000":"Panorama photo capturing is not start or is finished","3002":"Panorama photo is capturing","3005":"Panorama photo is synthesizing"}
+            # NOTE: not enum-constrained, real messages have been observed with current_step: 0, which isn't a documented value
+            attribute :current_step, Types::Integer
+
+            attribute :percent, Types::Integer.constrained(gteq: 0, lteq: 100)
+          end
+
+          attribute? :ext do
+            # {"0":"Capturing","1":"Recording","2":"Smart Low-Light","3":"Panorama","-1":"Unsupported mode","4":"Timed Shot"}
+            attribute? :camera_mode, Types::CameraMode
+          end
+        end
+      end
+
+      def humanized_summary_interpolation
+        super.merge(
+          status: data.output.humanized_status,
+          percent: data.output.progress.percent
+        )
+      end
+    end
+  end
+end

data/lib/dji_mqtt_connect/messages/thing/product/events/device_format.rb

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+module DjiMqttConnect
+  module Thing::Product
+    # Dock Data Formatting Progress
+    # https://developer.dji.com/doc/cloud-api-tutorial/en/api-reference/dock-to-cloud/mqtt/dock/dock3/cmd.html#dock-data-formatting-progress
+    class DeviceFormatEventsMessage < EventsMessage
+      attribute :_method, Types::String.enum("device_format")
+
+      attribute :data do
+        attribute :result, Types::ResultCode
+        include Mixins::ResultCode
+
+        attribute :output do
+          # {"sent":"sent","in_progress":"in progress","ok":"success","paused":"paused","rejected":"rejected","failed":"failed","canceled":"canceled or stopped","timeout":"timeout"}
+          attribute :status, Types::ServicesOutputStatus
+          include Mixins::ServicesOutputStatus
+
+          attribute :progress do
+            # {"min":"0","max":"100","step":"1"}
+            attribute :percent, Types::Integer.constrained(gteq: 0, lteq: 100)
+
+            # NOTE: step_key isn't in the documented field table for this message, only shown in the
+            # example payload with a placeholder value ("xxx"), so it's not constrained to Types::EventsProgressStepKey
+            attribute? :step_key, Types::String
+          end
+        end
+      end
+
+      def humanized_summary_interpolation
+        super.merge(
+          status: data.output.humanized_status,
+          percent: data.output.progress.percent
+        )
+      end
+    end
+  end
+end

data/lib/dji_mqtt_connect/messages/thing/product/services/live_camera_change.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+module DjiMqttConnect
+  module Thing::Product
+    # Switch live streaming camera
+    # https://developer.dji.com/doc/cloud-api-tutorial/en/api-reference/dock-to-cloud/mqtt/dock/dock3/live.html#switch-live-streaming-camera
+    class LiveCameraChangeServicesMessage < ServicesMessage
+      def self.build(data:, bid: generate_bid, tid: generate_tid, timestamp: current_timestamp)
+        new(
+          bid: bid,
+          tid: tid,
+          data: data,
+          timestamp: timestamp,
+          _method: "live_camera_change"
+        )
+      end
+
+      CAMERA_POSITION_INSIDE_DOCK = 0
+      CAMERA_POSITION_OUTSIDE_DOCK = 1
+
+      attribute :_method, Types::String.enum("live_camera_change")
+
+      attribute :data do
+        # Formatted as {sn}/{camera_index}/{video_index}
+        attribute :video_id, Types::String
+
+        # {"0":"Inside the dock","1":"Outside the dock"}
+        attribute :camera_position, Types::Integer.enum(
+          CAMERA_POSITION_INSIDE_DOCK,
+          CAMERA_POSITION_OUTSIDE_DOCK
+        )
+      end
+    end
+  end
+end

data/lib/dji_mqtt_connect/messages/thing/product/services_reply/drc_mode_enter.rb

@@ -5,6 +5,9 @@ module DjiMqttConnect
     class DrcModeEnterServicesReplyMessage < ServicesReplyMessage
       attribute :_method, Types::String.enum("drc_mode_enter")
 
+      # NOTE: DJI sometimes omits the timestamp for a drc_mode_enter services reply message
+      attribute? :timestamp, Types::TimestampMS
+
       attribute :data do
         attribute :result, Types::ResultCode
         include Mixins::ResultCode

data/lib/dji_mqtt_connect/messages/thing/product/services_reply/drc_mode_exit.rb

@@ -5,6 +5,9 @@ module DjiMqttConnect
     class DrcModeExitServicesReplyMessage < ServicesReplyMessage
       attribute :_method, Types::String.enum("drc_mode_exit")
 
+      # NOTE: DJI sometimes omits the timestamp for a drc_mode_exit services reply message
+      attribute? :timestamp, Types::TimestampMS
+
       attribute :data do
         attribute :result, Types::ResultCode
         include Mixins::ResultCode

data/lib/dji_mqtt_connect/messages/thing/product/services_reply/live_camera_change.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module DjiMqttConnect
+  module Thing::Product
+    class LiveCameraChangeServicesReplyMessage < ServicesReplyMessage
+      attribute :_method, Types::String.enum("live_camera_change")
+    end
+  end
+end

data/lib/dji_mqtt_connect/messages/thing/product/state_message.rb

@@ -177,7 +177,8 @@ module DjiMqttConnect
           attribute :available_video_number, Types::Integer
           attribute :coexist_video_number_max, Types::Integer
           attribute :device_list, Types::Array do
-            attribute :sn, Types::SerialNumber
+            # NOTE: DJI sometimes sends a blank serial number for a device
+            attribute :sn, Types::SerialNumber | Types::Nil
             attribute :available_video_number, Types::Integer
             attribute :coexist_video_number_max, Types::Integer
             attribute :camera_list, Types::Array do

data/lib/dji_mqtt_connect/types.rb

@@ -197,6 +197,7 @@ module DjiMqttConnect
       "turn_on_drone",
       "drone_paddle_forward",
       "close_cover",
+      "close_drone",
       "drone_paddle_reverse",
       "drone_paddle_stop",
       "free_putter",

data/lib/dji_mqtt_connect/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module DjiMqttConnect
-  VERSION = "0.1.35"
+  VERSION = "0.1.35.2"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: dji_mqtt_connect
 version: !ruby/object:Gem::Version
-  version: 0.1.35
+  version: 0.1.35.2
 platform: ruby
 authors:
 - Sphere Drones
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-03-12 00:00:00.000000000 Z
+date: 2026-08-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -139,11 +139,13 @@ files:
 - lib/dji_mqtt_connect/client.rb
 - lib/dji_mqtt_connect/error.rb
 - lib/dji_mqtt_connect/factories.rb
+- lib/dji_mqtt_connect/factories/events/camera_photo_take_progress.rb
 - lib/dji_mqtt_connect/factories/events/charge_close.rb
 - lib/dji_mqtt_connect/factories/events/charge_open.rb
 - lib/dji_mqtt_connect/factories/events/cover_close.rb
 - lib/dji_mqtt_connect/factories/events/cover_force_close.rb
 - lib/dji_mqtt_connect/factories/events/cover_open.rb
+- lib/dji_mqtt_connect/factories/events/device_format.rb
 - lib/dji_mqtt_connect/factories/events/obstacle_avoidance_notify.rb
 - lib/dji_mqtt_connect/factories/events/ota_progress.rb
 - lib/dji_mqtt_connect/factories/events_messages.rb
@@ -181,6 +183,7 @@ files:
 - lib/dji_mqtt_connect/factories/services/photo_storage_set.rb
 - lib/dji_mqtt_connect/factories/services/video_storage_set.rb
 - lib/dji_mqtt_connect/factories/services_messages.rb
+- lib/dji_mqtt_connect/factories/services_reply/live_camera_change.rb
 - lib/dji_mqtt_connect/factories/state_messages.rb
 - lib/dji_mqtt_connect/marshals/sys/product/status_marshal.rb
 - lib/dji_mqtt_connect/marshals/sys/product/status_reply_marshal.rb
@@ -200,12 +203,14 @@ files:
 - lib/dji_mqtt_connect/messages/sys/product/status_reply/update_topo.rb
 - lib/dji_mqtt_connect/messages/sys/product/status_reply_message.rb
 - lib/dji_mqtt_connect/messages/thing/product/events/airsense_warning.rb
+- lib/dji_mqtt_connect/messages/thing/product/events/camera_photo_take_progress.rb
 - lib/dji_mqtt_connect/messages/thing/product/events/charge_close.rb
 - lib/dji_mqtt_connect/messages/thing/product/events/charge_open.rb
 - lib/dji_mqtt_connect/messages/thing/product/events/cover_close.rb
 - lib/dji_mqtt_connect/messages/thing/product/events/cover_force_close.rb
 - lib/dji_mqtt_connect/messages/thing/product/events/cover_open.rb
 - lib/dji_mqtt_connect/messages/thing/product/events/device_exit_homing_notify.rb
+- lib/dji_mqtt_connect/messages/thing/product/events/device_format.rb
 - lib/dji_mqtt_connect/messages/thing/product/events/device_log.rb
 - lib/dji_mqtt_connect/messages/thing/product/events/device_reboot.rb
 - lib/dji_mqtt_connect/messages/thing/product/events/drone_close.rb
@@ -301,6 +306,7 @@ files:
 - lib/dji_mqtt_connect/messages/thing/product/services/ir_metering_area_set.rb
 - lib/dji_mqtt_connect/messages/thing/product/services/ir_metering_mode_set.rb
 - lib/dji_mqtt_connect/messages/thing/product/services/ir_metering_point_set.rb
+- lib/dji_mqtt_connect/messages/thing/product/services/live_camera_change.rb
 - lib/dji_mqtt_connect/messages/thing/product/services/live_lens_change.rb
 - lib/dji_mqtt_connect/messages/thing/product/services/live_set_quality.rb
 - lib/dji_mqtt_connect/messages/thing/product/services/live_start_push.rb
@@ -357,6 +363,7 @@ files:
 - lib/dji_mqtt_connect/messages/thing/product/services_reply/ir_metering_area_set.rb
 - lib/dji_mqtt_connect/messages/thing/product/services_reply/ir_metering_mode_set.rb
 - lib/dji_mqtt_connect/messages/thing/product/services_reply/ir_metering_point_set.rb
+- lib/dji_mqtt_connect/messages/thing/product/services_reply/live_camera_change.rb
 - lib/dji_mqtt_connect/messages/thing/product/services_reply/live_lens_change.rb
 - lib/dji_mqtt_connect/messages/thing/product/services_reply/live_set_quality.rb
 - lib/dji_mqtt_connect/messages/thing/product/services_reply/live_start_push.rb