ANDROID SDK Release Notes. Release Date: Overview: New APIs: Bugs Fixes: Sample Codes Updates: Mobile SDK version updated to:v2.4.

Transcription

1 Release Date: Overview: Mobile SDK version updated to:v2.4.1 New APIs: 1. (setrccontrolgimbaldirection,getrccontrolgimbaldirection) added in DJIRemoteController for changing the gimbal direction controlled by the top left wheel for Inspire 1. Bugs Fixes: 1. Fixed wrong current value of battery bug. 2. Corrected the return value of getdjigimbalcapacity' API for Phantom3 and Inspire Fixed battery activation in SDK. 4. The file downloaded by fetchmediadata' will be stored in the correct place. Sample Codes Updates: 1. Added the demo for setrccontrolgimbaldirection and getrccontrolgimbaldirection for Inspire 1 in RemoteControllerDemoActivity. 2. Added the demo for rotation to 30, 60, 120 degree to the north of the earth in GsProtocolJoystickDemoActivity. 3. Added the demo for set video standard and get video standard in CameraProtocolDemoActivity. 4. Added the demo for showing SDCard remainsize and remaincapturecount in the bottom left corner of Playback Mode in CameraProtocolDemoActivity. 5. Added the demo for setting the Resolution and Frame Rate for the video in CameraProtocolDemoActivity.

2 Release Date: Overview: Mobile SDK version updated to:v2.4.0 General: 1. Integrate the FollowMe and IOC function into the latest GroundStation 2. Integrate the speed control by the remote controller in all the mode in Grou ndstation 3. Modify the cameraexposuremode setting or getting method 4. Fix the failed to select the all documents problem bugs in playback section. Modified: 1. Modified altitude and distance limitation. Enabled setting multiple limitation factors (e.g. altitude and distance) simultaneously. 2. Modified the interface for acquire firmware version of the on-board camera for Inspire 1 and Phantom 3 series aircraft: public void getcamerafirmversion(final String separator,final DJIExecuteResultCallback mcallback) -> public void getfirmwareversion(final DJIExecuteStringResultCallback mcallback) 3. Deprecated the class of:djiinspiremcsystemstate 4. Renamed compassstatus to iscompasserrorstatus in DJIMainControllerSystemState.java and the corresponding comments for this attribute. 5. Fixed the typo of DJIRemoteControllerAttitude: public boolean footstool; ->public boolean foolstool; 6. Fixed the typo of lontitude, changed the name into longitude for DJIGroundStationWaypoint class.

3 7. Change the following interface for modifying files: fetchmedialist(djip3adownloadlistener<djip3amediadirinfo> mcallback) -> fetchmedialist(djidownloadlistener<djimediadirinfo> mcallback) fetchmediadata(djip3amediainfo mdjimedia, DJIP3ADownloadListener<DJIMediaFile> mcall) -> fetchmediadata(file destdir, DJIMediaInfo mdjimedia, DJIDownloadListener<DJIMediaFile> mcall) fetchmediathumbnail(djip3amediainfo mdjimedia, DJIP3ADownloadListener<DJIMediaFile> mcall) -> fetchmediathumbnail(file destdir, DJIMediaInfo mdjimedia, DJIDownloadListener<DJIMediaFile> mcall) 8. Fixed the typo: DJIGerneralListener -> DJIGeneralListener 9. Changed the parameters in getbatteryerrortype method : getbatteryerrortype(djismartbatteryexecuteresult mresult) -> getbatteryerrortype(djibatterygeterrortypecallback mcallback) 10. Changed the value of pitch,roll,yaw,velocityx,velocityy,velocityz from int to float for DJIGroundStationFlyingInfo class. Added: 1. Added interface for acquiring serial number of the aircraft: public void getaircraftsn(final DJIExecuteStringResultCallback mcallback) 2. Added interface for modifying Home Point in Follow Me mode: public void enablefollowmechangehomepoint(boolean enable,final DJIExecuteResultCallback mcallback) 3. Added SN and UI callback for main controller demo in SDK demo section. 4. Product type auto recognition process. 5. Added interface for obtaining firmware version of main controller, gimbal, battery, video downlink and remote controller for Inspire and Phantom 3 series aircraft: public void getfirmwareversion(final DJIExecuteStringResultCallback mcallback)

4 6. Added hardware decoding process. Added PreviewDemoHwDecodeActivity for demo. 7. Added GetVideoFrameDataOnlyDemoActivity to receive decoded video stream data. 8. Added button in the demo (maincontroller \ battery\ gimbal\ rc \ image transmitter demo) for acquiring firmware version for Inspire and Phantom 3 series aircraft. 9. Added Inspire 1 and Phantom 3 playback process. Being able to download SDCARD file list from the camera. 10. Adde public boolean isnavigationmodeenabled parameter in DJIMainControllerSystemState.java: 11. Added testing code for isnavigationmodeenabled in main controller demo. 12. Added testing BTH for stopping compass calibration in main controller demo. 13. Added data encryption process for remote controller. 14. Added getflylimitparameter interface. 15. Adde following methods: fetchmedialist, fetchmediadata, fetechmediathumbnail, fetechmediapreviewimage for Inspire and Phantom 3 series aircraft. 16. Added fetechmediapreviewimage for Phantom 3 Advanced. 17. Added New Playback mode for the camera. Bugs Fixed: 1. Fixed exposure issue in setting the shutter. 2. Fixed issue of failing to set pitch and yaw simultaneously. 3. Fixed issue of receiving Open Ground Station error when uploading waypoint in OpenGroundStation callback 4. Fixed issue of the return value of getcontinuousparams is assigned as 0,0. 5. Fixed issue of return value of designvolume is always 0 for battery information class.

5 6. Fixed issue of incorrect display of battery temperature. 7. Introduced DJIErrorType to handle all battery error. 8. Fixed issue of error return state for FlyControlstate. Deprecated Methods: 1. setchannelparams removeslave removemaster methods in DJIRemoteController class. 2. fetchmedialist(djimediafetchcallback mcallback), fetchmediathumbnail(djimedia mdjimedia, DJIExecuteResultCallBack mcallback), fetchmediadata(djimedia mdjimedia, DJIReceivedFileData mcall) in DJIInspireCamera class.

6 Release Date: Overview: Mobile SDK version updated to:v2.3.0 General: 1. Integrate the FollowMe and IOC function into the latest GroundStation 2. Integrate the speed control by the remote controller in all the mode in Grou ndstation 3. Modify the cameraexposuremode setting or getting method 4. Fix the failed to select the all documents problem bugs in playback section. New features: 1. Added remotecontrolspeed,movingspeed in DJIGroundStationTask and the corresponding comments. 2. Added hotpointreason, followmemissionstatus, followmegpslevel, followmedistance, followmereason in DJIGroundStationMissionPushInfo and the corresponding comments. 3. Added TURNING in DJIGroundStationPathMode and the corresponding comments. 4. Added Navi_Mode_FollowMe in GroundStationStatusPushType and the corresponding comments. 5. Added DJIGroundStationIocType, GroundStationFollowMeMode, GroundStationFollowMeYawMode in DJIGroundStationTypeDef and the corresponding comments. 6. Standardized the definition of error codes for executing Ground Station related functions, added more error codes to the new version of Gr ound Station. 7. Added dampingdistance in DJIGroundStationWaypoint and the corresponding comments.

7 8. Added class DJIFollowMeInitializationInfo, class DJIFollowMeTarget in package dji.sdk.api.groundstation and the corresponding comments. 9. Added new interfaces for IOC feature;added GsProtocolIocDemoActiviy in SDK DEMO, the new interfaces are listed as follows:public void enteriocmode(djigroundstationioctype ioctype,final DJIGroundStationExecuteCallBack mcallback) public void exitiocmode(final DJIGroundStationExecuteCallBack mcallback). 10. Added interfaces for Follow-Me feature, added GsProtocolFollowMeDemoActivity in SDK DEMO, the new interfaces are listed as follows: public void startfollowme(djifollowmeinitializationinfo info, final DJIGroundStationExecuteCallBack mcallback) public void pausefollowme(final DJIGroundStationExecuteCallBack mcallback) public void resumefollowme(final DJIGroundStationExecuteCallBack mcallback) public void sendfollowtargetgps(djifollowmetarget target,final DJIGroundStationExecuteCallBack mcallback). 11. Added the functions setting or getting the exposure mode of the camera public void setcameraexposuremode(cameraexposuremode mode,final DJIExecuteResultCallback mcall) public void getcameraexposuremode(final DJIExecuteResultCallback mcall). 12. Added a series of state pushes in DJIMainController, including Return-to- Home (RTH), RTH Heading Adjustment, RTH Ascent, RTH Flight, RTH Landing, and RTH Complete. 13. Added a show bar to show the task progress in GroundStation DEMO of SDK DEMO. 14. Deprecated getdjimc() in DJIDrone, recommend to use getdjimaincontroller. 15. Added the inferface of getcameramode to obtain the mode of the camera (capturing, videorecording, playback, download), the interface is as follows: public void getcameramode(final DJICameraModeCallBack mcall).

8 16. Added a function to get the camera's firmware version public void getcamerafirmversion(final String separator, final DJIExecuteResultCallback mcallback). 17. Deleted the functions of getaircraftioctype, setaircraftioctype in the DJIInspireMainController. 18. Deprecated function setlowbatterywarning, getlowbatterywarning, setseriousbatterywarning, getseriousbatterywarning. 19. Add comment that startwaypointindex is only supported by the P2V+ and P2V. Revised: 1. Standardized the callback interface used by Ground-Station related functions, the interfaces are changed to DJIGroundStationExecuteCallback, deleted the following callback interfaces: DJIGroundStationTakeOffCallBack DJIGroundStationHoverCallBack DJIGroundStationResumeCallBack DJIGroundStationCancelCallBack DJIGroundStationOneKeyFlyCallBack DJIGroundStationGoHomeCallBack. 2. Deleted Way_Point_Action_Gimbal_Yaw in GroundStationOnWayPointAction enum class. 3. Revised the description of the range for altitude in DJIHotPointInitializationInfo: Hot Point's altitude[5m ~ The limit altitude(eg. 120m)]. 4. Revised the description of the range for radius in DJIHotPointInitializationInfo: The track radius[5m ~ 500m]. 5. Revised the description of the range for velocity in DJIHotPointInitializationInfo: Angular velocity of drone, the unit is degree/second. in range [0, 30], default is Deleted liftingmaxspeed,horizontalmaxspeedm,yawmaxspeed in DJIGroundStationTask.

9 7. Deleted hotpointangle in DJIGroundStationMissionPushInfo. 8. Revised the names of enums in GroundStationHotPointNavigationMode: Auto -> SurroundHeadingAlongTheCircleLookingForward Forward_To_Hot_Point -> SurroundHeadingTowardHotPoint Backward_To_Hot_Point -> SurroundHeadingBackwardHotPoint Remote_Control -> SurroundHeadingControlByRemoteController Lock -> SurroundHeadingAlongTheCircleLookingBackward. 9. Revised the interface for downloading files in Inpire1/Phantom 3 Professional downloadallselectedfiles(string) -> downloadallselectedfiles(file). Bug Fixes: 1. Solved the bug that uploading waypoints will not stop in Inspire1/Phantom 3 Series. 2. Solved the bug that ismissionvalid is always false in DJIGroundStationExecutionPushInfo of Inspire1/Phantom 3 Series. 3. Solved the bug that speed is always 0 in DJIMainControllerSystemState in Inspire1/Phantom 3 Series. 4. Solved the bug that when mobile android devices connect with the remote controllers with the latest firmware version, a nullpointer error may occur. Notification: As the interfaces and members in the new Ground Station related SDK APIs have a huge adjustment, if you want to use the Ground Station related SDK APIs in this version, please update the latest firmware on dev.dji.com and make adjustments in your codes related to the ground station feature.

10 Release Date: Overview: Mobile SDK version updated to:v2.1.0 General: 1. Support the Phantom3 Advanced for the SDK. 2. Support Full Data Transmission Function which can communicate with external devices on M Download method for Phantom 3 Advanced is similar to Phantom 2 Vision plus using FetchMediaList method. 4. Fix the bugs for no image transmission and camera setting. 5. Fix the fetal bugs for gimbal rotation and remote controller.

11 All Updates: 1. Modified the absolute pitch range of gimbal from [0,1000] to [-90,30] for Inspire 1 and Phantom Deleted all APIs related to Follow Me, which is not ready, in GroundStation class. 3. Updated the document of WayPointCount in DJIGroundStationTask class, whose value should represent the total number of waypoints in the Arraylist of Tasks. 4. Updated the document of TurnMode in DJIGroundStationWaypoint class: 1 means anti-clockwise and 0 means clockwise when turning in yaw axis. 5. Updated the document of movingmode in the DJIGroundStationTask: GSHeadingTowardNextWaypoint: Aircraft will head to the next waypoint. GSHeadingUsingInitialDirection: Aircraft will keep its heading direction the same as the one when taking off. GSHeadingControlByRemoteController: Aircraft's heading is controlled by the remote controller. GSHeadingUsingWaypoinHeading: Aircraft's heading will use the waypoint's heading value. 6. Support Phantom 3 Advanced: Add DJIPhantom3AdvancedCamera class. The different between DJIInspireCamera and DJIPhantom3AdvancedCamera is listed as follows: (1) DJIPhantom3AdvancedCamera does not support 4K recording resolution settings. (2)The way for video/photo playback and downloading is different. DJIPhantom3AdvancedCamera use API method: fetchmedialist, DJIMediaFile to realize the video/photo playback and downloading. 7. Support Android Open Accessory(AOA) protocol among the remote controller and the connected Android device. Developers need to keep DJIAoaActivity.java and DemoBaseActivity.java in their project for AOA support. The DJIAoaActivity should be set as the main activity. The DemoBaseActivity should be extended by other new added activities. 8. Add the demo of setting ioc in main controller activity.

12 9. Delete public DJIGroundStationWaypoint(double mlatitude, double mlongitude, int actionnum, int repeat Num). It can be realized through public DJIGroundStationWaypoint(double mlatitude, double mlongitude). 10. The attribute of the staytime of the waypoint changed from float to short. 11. The units of the altitude of MCU callback changed from decimeter to meter. 12. Modify the DJIGroundStation Task: change from liftspeed to liftingmaxspeed, horizontalspeed to horizontalmaxspeed, angelspeed to yawmaxspeed. 13. Increase the fine tuning angle value. 14. Increase the documents for different working mode of the camera. 15. Update the documents for DJIGroundStationWayPointAction. Bug Fixes: 1. Fixed the bug that when users try to upload waypoint with the current waypoint task still running, the API will return success. 2. Fixed the random failure when uploading a new waypoint task after the previous task has been accomplished. 3. Fixed the bug that DJIGroundStationMovingMode.GSHeadingUsingWaypoingHeading does not work. 4. Fixed the bug of "DownloadGroundStationTask", which should return all uploaded waypoints in the current task. 5. Fixed the heap corruption crash issue when using groundstation with Android5.0.1 and Phantom 2 Vision plus. 6. Fixed the bug that Phantom 3 Advanced will return error code when downloading files.

13 7. Fixed the parameter of cancelhotpoint, which should be DJIGroundStationCancelCallBack. 8. Fixed the bug of returning the error of "invalid parameter" when setting exposure metering in camera protocol. 9. Fixed the bug of crashes when switching among different demo activities (e.g., between video preview, camera protocol). 10. Fixed the bug of returning timeout when starting FPV mode in Gimbal Protocol. 11. Fixed the bug of no video showing sometimes in P2V Fixed the bug of returning errors in setting the mode of remote controller. 13. Fixed the bug of being unable to adjust Gimbal Pitch of Waypoint Action to a positive value. 14. Fixed the bug that the main controller information shown is 10 times larger than the real value. 15. Fixed the bug of simultaneously executing Ground Station tasks and hot point tasks. Now the priority of Ground Station tasks is higher. 16. Fixed the maximum action of every waypoint to 15. The repeat time of every action is 15 as well. Notification: 1. Support Full Data Transmission Function: a. Users could use SDK to send the data to external devices connected to the port of the Main Controller and receive the data back from the external ones as well. The size of the send/receive pack should be within 100 bytes. So far, the API can only support on Matrice100. b. The class DJIInspireMainController realizes the Full Data Transmission Function. The user needs to choose the DJIDroneType_Inspire1 when initing the SDK APIs. And use DJIDrone.getDjiMC() to obtain DJIInspireMainController instance.

14 c. Full Data Transmission send API: public void senddatatoexternaldevice(byte[] data, final DJIExecuteResultCallback mcallback) d. Full Data Transmission receive API: -(void)maincontroller:(djimaincontroller*)mc didreceiveddatafromexternaldevice:(nsdata*)data 2. It is not allowed to upload new waypoints when the previous waypoint task is still running. 3. The file download in Phantom 3 Pro and Inspire 1 is different from the one in Phantom 3 Advanced and Phantom 2 Vision+ due to the structure differences of the camera firmware. 4. We recommend 4Mbit/s and 6Mbit/s channels for image transmission. Under the circumstances of 8Mbit/s or 10Mbit/s, the decoding part might be not well-worked. The video preview may be stuttering and might lead to more crashes. We are still solving this problem. 5. When using playback mode, the modified file must be saved before clicking the PlayBack button, otherwise the file will be deleted. 6. We add more details in the description of function: updategimbalattitude (DJIGimbalRotation pitch,djigimbalrotation roll,djigimbalrotation yaw) in DJIInspireGimbal class.

15