14
12

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

More than 3 years have passed since last update.

#はじめに

センシンロボティクスの山本です。
ドローンの自動航行のためのWebシステム、アプリ開発に関わっています。
今回は、DJI Mobile SDK( Android 版 ) について、改めて公式マニュアルをしっかり読み直そうと思います。

概要

実際に動かす場合、DJIのドローンが必要です、Mobile SDK の対応機種は以下のページ (公式) に記載されています。
https://developer.dji.com/products/#!/mobile

version 4.13 からMavic mini が対応されたので、個人&ホビーでもやりやすくなったと思います ( ... 実際に飛ばすとなるとそうでも無いか。 )
githubに公式チュートリアルが公開されているので、作りたいアプリの機能に応じて参考にすることが出来ます。一通り、動かしてみると良いですが、個人的に参考になったのは以下のチュートリアルです。

Url 概要
Getting Started with DJI UX SDK とりあえず、このチュートリアルのコードでマニュアル飛行用に使えそうなデモ、ユーザインターフェース仕上がってます
Creating a MapView and Waypoint Application GoogleMap上でポイントを打って、飛行させるデモ。 WaypointV2 (Matrice 300が対応)のサンプルコードも含まれています
DJI Simulator Tutorial DJISimulatorのデモ。DJI Assistant2 のシミュレータとは違い( 公式ドキュメント) PCつなげる必要は無いので、他のチュートリアルにこのチュートリアルを参考に組み込むと便利。

(参考) チュートリアル一覧

UX SDK

UX SDK は、飛行中のUIの部品です、利用したい部品がwidgetとして定義されているので、飛行中の画面を提供するアプリであれば、使うのはMUSTです、そのまま利用できる部品が揃っています。

image.png

( 引用 ) https://developer.dji.com/mobile-sdk/documentation/android-tutorials/UXSDKDemo.html

※ こちらは、今回主役ではないので省略

Mobile SDK

ドローンへのコマンドの送信、ミッションの作成等、ドローンの操作はこれを使います。
今回はこちらのSDKのマニュアルの中から、Waypoint ミッションについて深堀りしてみます。
( GoogleMap のチュートリアルが、Waypoint ミッションです )

  • Waypoint ★
  • Hot Point
  • Follow Me
  • ActiveTrack
  • TapFly

Waypoint ミッションは、中継地点の緯度・経度・高さ等を指定してドローンを飛行させる方法です。

(参考) https://developer.dji.com/mobile-sdk/documentation/introduction/component-guide-missions.html

登場するクラス

以下をおさえておけば、おそらく、自由自在にドローン飛ばせます。( 実世界でなかなか飛ばせないですが。)

  • WaypointMissionOperator
  • WaypointMission
  • Waypoint
  • WaypointAction
  • WaypointActionType

WaypointMissionOperator

waypointミッションの開始や、ミッションのアップロードするために利用します。

    public WaypointMissionOperator getWaypointMissionOperator() {
        return DJISDKManager.getInstance().getMissionControl().getWaypointMissionOperator();
    }

    public void startMission() {
        // ミッションの作成
        ... (中略)
        getWaypointMissionOperator().loadMission(waypointMissionBuilder.build());

        // ミッションのアップロード
        getWaypointMissionOperator().uploadMission(new CommonCallbacks.CompletionCallback() {
            @Override
            public void onResult(DJIError error) {}
        });
        // ミッション開始 
        getWaypointMissionOperator().startMission(new CommonCallbacks.CompletionCallback() {
            @Override
            public void onResult(DJIError error) {}
        });
    }

WaypointMission

WaypointMissionの本体、Waypoint のリストと、各Waypointのアクションを設定する。
各種設定は、WaypointMission.Builderを利用する。

(参考) https://developer.dji.com/api-reference/android-api/Components/Missions/DJIWaypointMission_Builder.html

設定項目 説明
waypointList Waypointのリスト(各ポイントに設定できるアクションは後述)
gotoFirstWaypointMode 1つ目のポイントへの到達方法 SAFTYの場合、同じ高度まで上昇してからポイントに進む
finishedAction 終了後の動作
  • NO_ACTION(待機)
  • GO_HOME(ホームに戻る)
  • AUTO_LAND(着陸)
  • GO_FIRST_WAYPOINT(1つ目のポイントに戻り待機)
  • CONTINUE_UNTIL_END(stopボタン押すまで継続)
headingMode ドローンの機首方向
  • AUTO(進行方向)
  • USING_INITIAL_DIRECTION(1つめのポイントの方向)
  • CONTROL_BY_REMOTE_CONTROLLER(プロポ操作)
  • USING_WAYPOINT_HEADING (ポイント間で徐々に方向が変わる)
  • TOWARD_POINT_OF_INTEREST( POIの地点を向く )
flightPathMode コーナーの曲がり方の設定 NORMAL(直線) / CURVED(曲線)、コーナー半径は各ウェイポイントで指定可能
setExitMissionOnRCSignalLostEnabled プロポとドローンの信号が切れた場合にミッションを停止するかのフラグ。デフォルト false ...だと。
setGimbalPitchRotationEnabled ミッション中にジンバルのピッチ(上下方向)の操作を有効にするかのフラグ
repeatTimes ミッションを繰り返す回数。ミッションの停止コマンドで中断可能。
setPointOfInterest Point of Interest の緯度・経度を設定(LocationCoordinate2D)

... 使ったことのない操作がある、ふむふむ。
POI は、WaypointMission に設定するので、複数のPOIの座標は1つのWaypointMissionに1つとなる(気になるので、後日深追い)。

DJIWaypointV2 の場合、Waypoint 毎にPOIの設定が入れられる( Altitudeもset可能、設定した場合にどの様に動くか ... )。

Waypoint

設定項目 説明
coordinate 座標(緯度、経度)
altitude 高度。なお、離陸地点からの相対的な高度となる。ポイント間の高度が異なる場合は、ポイント移動中に徐々に高度が変わる
heading ドローンの方向(角度) -180 - 180, 0は True North。USING_WAYPOINT_HEADINGモードの場合、ポイント移動中に徐々に角度が変わる
cornerRadiusInMeters コーナリング時の半径
gimbalPitch ジンバルのピッチ。ジンバルの角度はWayPointではピッチしか設定できないようだ。( 飛行中にプロポ操作で変更はできる )
speed 速度、0〜15 m/s、以下の優先順位で決まる。
  • プロポ操作で調整した速度
  • speed で設定した速度
  • WaypointMissionOperatorで設定したautoFlightSpeed
  • getAutoFlightSpeed (※ 詳細は公式マニュアルを)
shootPhotoTimeInterval 等時間撮影の設定(秒数)、0の場合は OFF
shootPhotoDistanceInterval 等間隔撮影の設定(m)、0の場合は OFF
waypointActions ウェイポイントに設定したアクション

だんだん、力尽きてきました。説明が短めになってますがご容赦を。

WaypointAction

actionType / actionParam でウェイポイントで動作させるアクションを指定する。

WaypointActionType

設定項目 説明
STAY ホバリングする。 [0, 32767] milliseconds. ミリ秒っ!
START_TAKE_PHOTO カメラ撮影、6秒までに完了しない場合は次のアクションに移るとのこと。
START_RECORD 動画撮影の開始。同じく最大6秒。
STOP_RECORD 動画撮影の停止。同じく最大6秒
ROTATE_AIRCRAFT ドローンを回転させる。 [-180, 180] ウェイポイントのTurnMode(右回り/左回り)の方向に回転する
GIMBAL_PITCH ジンバルのピッチ(上下)角度の変更、 [-90, 0]

Waypointで指定するピッチと、アクションで指定するピッチがあるようだ。

(参考) https://developer.dji.com/api-reference/android-api/Components/Missions/DJIWaypoint_DJIWaypointAction.html#djiwaypoint_djiwaypointactiontype_inline

まとめ

改めて読んでみると、新しい発見や、そんな仕様があったのか。。。と、なかなか有意義でした。Matrice 300 用にはDJIWaypointV2Mission が利用できるため、こちらも近い内に。

参考資料

14
12
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
14
12

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?