class DJISDKManager
sealed class DJISDKManager
Declaration: | DJI.WindowsSDK |
---|---|
Description:
This class is the entry point for using the SDK with a DJI product. Most importantly, this class is used to register the SDK, and to connect to and access the product. This class also provides access to important feature managers. SDK Registration using must be successful before the SDK can be used with a DJI product.
该类是将SDK与DJI产品一起使用的入口点。最重要的是,这个类用于注册SDK,并连接和访问产品。这个类还提供了对重要特性管理器的访问。SDK注册使用必须成功,才能与DJI产品一起使用。
enum AppActivationState
enum AppActivationState
Declaration: | DJI.WindowsSDK |
---|---|
Description:
App激活状态。
Enum Members:
NOT_SUPPORTED | The aircraft’s firmware does not support the App Activation System. |
---|---|
LOGIN_REQUIRED | The application needs to be activated by the user through their DJI account. Use UserAccountManager to enable the user to log in. Log in is only required if the aircraft is located in China. |
ACTIVATED | The application is activated and flight restrictions turned off. |
UNKNOWN | Either the aircraft is disconnected or the connected product is not a DJI aircraft. |
enum AircraftBindingState
enum AircraftBindingState
Declaration: | DJI.WindowsSDK |
---|---|
Description:
飞机的捆绑状态。
Enum Members:
INITIAL | 飞机的绑定状态尚未确定。只有在DJI运行或基于DJI移动SDK的应用程序授权绑定信息到飞机之前,飞机才会处于这种状态。只有当用户在中国时才需要绑定。如果用户不在中国,那么在国家代码检查完成后,该状态将变为’ NOT_REQUIRED '。在这种状态下,飞机将有30米的高度和50米的半径限制。 |
---|---|
UNBOUND | 飞机目前没有飞行,需要飞行(因为它在中国)。在这种状态下,飞机将有30m的最大飞行高度和50m的最大飞行距离限制。用户应与DJI Go完成一次性绑定过程,以消除飞行限制。 |
UNBOUND_BUT_CANNOT_SYNC | 这架飞机正在中国境内飞行,目前尚未起飞。该飞机可以使用大疆Go绑定。如果DJI Go连接到飞机上,那么绑定将存储在飞机上。如果DJI Go在绑定过程中没有连接到飞机,那么绑定结果将存储在服务器上。SDK可以查询此服务器查看绑定是否已经发生,如果已经发生,则下载绑定到飞机。但是,如果飞机未绑定,且服务器不可访问,则会显示此状态。用户应该将移动设备连接到Internet以刷新此状态。 |
BOUND | 飞机起飞了。 |
NOT_SUPORTED | 这架飞机的固件不支持App激活系统。 |
UNKNOWN | 要么飞机断开连接,要么连接的产品不是DJI飞机。 |
NOT_REQUIRED | 这架飞机没有飞往中国,但目前不在中国境内。因此,不需要捆绑飞机。 |
property appActivationState
AppActivationState appActivationState { get; }
Declaration: | DJI.WindowsSDK |
---|---|
Description:
当前App激活状态。
property aircraftBindindState
AircraftBindingState aircraftBindindState { get; }
Declaration: | DJI.WindowsSDK |
---|---|
Description:
Current Aircraft binding state.
delegate AppActivationStateChangedEventHandler
delegate void AppActivationStateChangedEventHandler(AppActivationState state)
Declaration: | DJI.WindowsSDK |
---|---|
Description:
Delegate type that use to subscribe the App Activation state.
用于订阅应用程序激活状态的委托类型。
delegate AircraftBindingStateChangedEventHandler
delegate void AircraftBindingStateChangedEventHandler(AircraftBindingState state)
Declaration: | DJI.WindowsSDK |
---|---|
Description:
Delegate type that use to subscribe the aircraft binding state.
用于订阅飞机绑定状态的委托类型。
event AppActivationStateChanged
event AppActivationStateChangedEventHandler AppActivationStateChanged
Declaration: | DJI.WindowsSDK |
---|---|
Description:
Subscribe the event to receive the change of App ActivationState state.
订阅事件以接收App ActivationState状态的变化。
event AircraftBindingStateChanged
event AircraftBindingStateChangedEventHandler AircraftBindingStateChanged
Declaration: | DJI.WindowsSDK |
---|---|
Description:
Subscribe the event to receive the change of Aircraft Binding State state.
订阅事件以接收飞机绑定状态状态的更改。
enum SDKError
enum SDKError
Declaration: | DJI.WindowsSDK |
---|---|
Description:
Error codes that represents errors that may occur when using SDK.
表示在使用SDK时可能发生的错误的错误代码。
Enum Members:
NO_ERROR | No error. This code is returned when a command or a query succeeds. |
---|---|
REQUEST_HANDLER_NOT_FOUND | The handler for the quest is not not found. One possible reason is that the component is not connected. |
REQUEST_NOT_SUPPORTED_BY_HANDLER | The request is not supported by the handler. |
REQUEST_TIMEOUT | The request timeouted. Re-try later. |
SEND_PACK_FAILURE | SDK failed to send the data to the DJI product. One possible reason is that the link between SDK and the product is not stable. |
DISCONNECTED | The handler disconnects during the execution. |
INVALID_PARAM | The parameter is invalid. |
SYSTEM_ERROR | Internal system error occurs. |
COMMAND_INTERRUPTED | The command is interrupted. |
PARAMETERS_GET_ERROR | Error occurs when trying to get the data. |
PARAMETERS_SET_ERROR | Error occurs when trying to set the data. |
INVALID_RESPOND | The respond data from the firmware is either empty or corrupted. |
PARAM_OUT_OF_RANGE | The parameter is out of the valid range. |
INVALID_REQUEST_IN_CURRENT_STATE | The request is invalid in the current state. |
EXECUTION_FAILED | The execution is failed. |
MISSION_WAYPOINT_NULL_MISSION | The mission is null. |
MISSION_WAYPOINT_MAX_FLIGHT_SPEED_INVALID | The max flight speed exceeds the valid range. |
MISSION_WAYPOINT_REPEAT_TIMES_INVALID | The repeat times are less than 0. |
MISSION_WAYPOINT_COUNT_INVALID | The waypoint count is less than 2. |
MISSION_WAYPOINT_DISCONNECTED | The waypoint handler is in disconnected state. The request is rejected. |
MISSION_WAYPOINT_DOWNLOAD_UNNECESSARY | The local information of the waypoint mission is complete. It is not necessary to download it from the aircraft. |
MISSION_WAYPOINT_ALREADY_STARTED | The waypoint mission is already started. |
MISSION_WAYPOINT_CANCELLED | The request for a waypoint mission is cancelled. |
MISSION_WAYPOINT_FAILED | The waypoint mission execution failed. |
MISSION_WAYPOINT_TIMEOUT | The waypoint mission execution timeouted. |
MISSION_WAYPOINT_MODE_ERROR | The waypoint mission cannot be executed because of the flight mode error. |
MISSION_WAYPOINT_GPS_NOT_READY | The waypoint mission cannot be executed because of invalid GPS location of the aircraft. |
MISSION_WAYPOINT_MOTORS_DID_NOT_START | Internal error 0x07. |
MISSION_WAYPOINT_TAKE_OFF | Internal error 0x08. |
MISSION_WAYPOINT_IS_FLYING | Internal error 0x09. |
MISSION_WAYPOINT_NOT_AUTO_MODE | Internal error 0x0A. |
MISSION_WAYPOINT_MAX_NUMBER_OF_WAYPOINTS_UPLOAD_LIMIT_REACHED | The number of waypoints exceeded the max count. |
MISSION_WAYPOINT_UPLOADING_WAYPOINT | The handler is uploading waypoints. |
MISSION_WAYPOINT_KEY_LEVEL_LOW | Internal error 0x0D. |
MISSION_WAYPOINT_NAVIGATION_MODE_DISABLED | The ground station mode is not enabled. |
MISSION_IOC_TOO_CLOSE_TO_HOME_POINT | The aircraft is too close to the home point. |
MISSION_IOC_TYPE_UNKNOWN | Invalid IOC type. |
MISSION_HOTPOINT_VALUE_INVALID | Invalid parameters. |
MISSION_HOTPOINT_LOCATION_INVALID | Invalid location as a hotpoint. |
MISSION_HOTPOINT_DIRECTION_UNKNOWN | Invalid direction. |
MISSION_HOTPOINT_MISSION_PAUSED | The hotpoint mission is already paused. |
MISSION_HOTPOINT_MISSION_NOT_PAUSED | The hotpoint mission is already resumed. |
MISSION_FOLLOW_ME_DISTANCE_TOO_LARGE | The distance between the aircraft and the target is too far. |
MISSION_FOLLOW_ME_DISCONNECT_TIME_TOO_LONG | The following targer is lost. |
MISSION_FOLLOW_ME_GIMBAL_PITCH_ERROR | Gimbal’s pitch angle is too large. |
MISSION_WAYPOINT_ALTITUDE_TOO_HIGH | Aircraft’s altitude is too high. |
MISSION_WAYPOINT_ALTITUDE_TOO_LOW | Aircraft’s altitude is too low. |
MISSION_WAYPOINT_MISSION_RADIUS_INVALID | Invalid surrounding radius. |
MISSION_WAYPOINT_MISSION_SPEED_TOO_HIGH | The circular velocity is too large. |
MISSION_WAYPOINT_MISSION_ENTRY_POINT_INVALID | Entry point invalid. |
MISSION_WAYPOINT_MISSION_HEADING_MODE_INVALID | The waypoint has invalid heading. |
MISSION_WAYPOINT_MISSION_RESUME_FAILED | Failed to resume the mission, because the aircraft is far away from the mission. |
MISSION_WAYPOINT_MISSION_RADIUS_OVER_LIMIT | Over max flight radius. |
MISSION_WAYPOINT_NAVIGATION_MODE_NOT_SUPPORTED | Waypoint mission is not supported by the aircraft. |
MISSION_WAYPOINT_DISTANCE_FROM_MISSION_TARGET_TOO_LONG | Mission start point is too far away from the aircraft’s current location. |
MISSION_WAYPOINT_IN_NOVICE_MODE | The novice mode is enabled. |
MISSION_WAYPOINT_MULTI_MODE_IS_OFF | The multiple mode is disabled. |
MISSION_WAYPOINT_RTK_IS_NOT_READY | RTK is not ready. |
MISSION_WAYPOINT_RC_MODE_ERROR | RC mode error. |
MISSION_WAYPOINT_AIRCRAFT_IN_NO_FLY_ZONE | The aircraft is inside a no fly-zone. |
MISSION_WAYPOINT_IOC_WORKING | The aircraft is in IOC mode. |
MISSION_WAYPOINT_MISSION_NOT_INITIALIZED | Aircraft’s mission is not initialized. |
MISSION_WAYPOINT_MISSION_NOT_EXIST | No mission is running. |
MISSION_WAYPOINT_MISSION_CONFLICT | Other mission is running. |
MISSION_WAYPOINT_MISSION_ESTIMATE_TIME_TOO_LONG | Mission will consume too much time. |
MISSION_WAYPOINT_HIGH_PRIORITY_MISSION_EXECUTING | High priority mission is running. |
MISSION_WAYPOINT_GPS_SIGNAL_WEAK | The GPS signal is weak. |
MISSION_WAYPOINT_LOW_BATTERY | The remaining charge is too low. |
MISSION_WAYPOINT_AIRCRAFT_NOT_IN_THE_AIR | The aircraft is not in the air. Takeoff first. |
MISSION_WAYPOINT_MISSION_PARAMETERS_INVALID | Invalid parameters. |
MISSION_WAYPOINT_MISSION_CONDITION_NOT_SATISFIED | The waypoint mission request cannot be executed. |
MISSION_WAYPOINT_MISSION_ACROSS_NO_FLY_ZONE | The waypoint mission is invalid because it will cross a no fly-zone. |
MISSION_WAYPOINT_HOME_POINT_NOT_RECORDED | The home point location is not refreshed. |
MISSION_WAYPOINT_WAYPOINT_NOT_RUNNING | No waypoint mission is being executed. |
MISSION_WAYPOINT_MISSION_INFO_INVALID | Invalid parameters in waypoint mission. |
MISSION_WAYPOINT_WAYPOINT_INFO_INVALID | Invalid parameters in waypoints. |
MISSION_WAYPOINT_WAYPOINT_TRACE_TOO_LONG | The total distance of waypoints is too large. |
MISSION_WAYPOINT_WAYPOINT_TOTAL_TRACE_TOO_LONG | The total distance of the waypoint mission is too large. |
MISSION_WAYPOINT_WAYPOINT_INDEX_OVER_RANGE | Waypoint index error. |
MISSION_WAYPOINT_WAYPOINT_DISTANCE_TOO_CLOSE | The distance of two adjacent waypoints is too close. |
MISSION_WAYPOINT_WAYPOINT_DISTANCE_TOO_LONG | The distance of two adjacent waypoints is too large. |
MISSION_WAYPOINT_WAYPOINT_INVALID_CORNER_RADIUS | The corner radius is invalid. |
MISSION_WAYPOINT_WAYPOINT_ACTION_PARAMETER_INVALID | The waypoint mission action parameter is invalid. |
MISSION_WAYPOINT_WAYPOINT_MISSION_INFO_NOT_UPLOADED | The waypoint mission summary is not uploaded. |
MISSION_WAYPOINT_WAYPOINT_UPLOAD_NOT_COMPLETE | The waypoint mission is not uploaded completely. |
MISSION_WAYPOINT_WAYPOINT_REQUEST_IS_RUNNING | Internal error 0xED. |
MISSION_WAYPOINT_WAYPOINT_IDLE_VELOCITY_INVALID | Internal error 0xEE. |
MISSION_WAYPOINT_AIRCRAFT_TAKING_OFF | The aircraft is already taking off. |
MISSION_WAYPOINT_AIRCRAFT_LANDING | The aircraft is already landing. |
MISSION_WAYPOINT_AIRCRAFT_GOING_HOME | The aircraft is already going home. |
MISSION_WAYPOINT_AIRCRAFT_STARTING_MOTOR | The aircraft is already tring to start the motors. |
MISSION_WAYPOINT_WRONG_CMD | The command ID is wrong. |
MISSION_WAYPOINT_MISSION_ID_INVALID | The mission ID is invalid. |
FLY_SAFE_LOCAL_USER_TOKEN_INVALID | The user token is invalid. |
FLY_SAFE_NETWORK_INVALID | The network is not reachable. |
FLY_SAFE_SERVER_DATA_ERROR | Invalid data from the server. |
FLY_SAFE_SIGNATURE_ERROR | Signature error. |
FLY_SAFE_CHECK_SIGNATURE_ERROR | Signature error. |
FLY_SAFE_INVALID_REQUEST | The request is invalid. |
FLY_SAFE_PAGE_NOT_FOUND | Received 404 respond. |
FLY_SAFE_USER_IS_NOT_LOGIN | The user is not logged in yet. |
FLY_SAFE_PACK_MANAGER_TIMEOUT | The communication between the aircraft and SDK timeouted. |
FLY_SAFE_PACK_MANAGER_WRONG_UNLOCK_VERSION | Unlock version mismatches. |
FLY_SAFE_PACK_MANAGER_WRONG_DEVICE_ID | Device ID mismatches. |
FLY_SAFE_WRONG_SERIAL_NUMBER | Serial number mismatches. |
FLY_SAFE_FILE_ERROR | The database file may be corrupted. |
FLY_SAFE_DB_INVALID_PARAMS | Passed invalid database query arguments. |
FLY_SAFE_DB_NOT_VALID | The database is invalid. |
FLY_SAFE_INVALID_AREA_IDS | The area ID is invalid. |
FLY_SAFE_FC_QUERY_FAILED | The query failed. |
FLY_SAFE_FC_OP_SET_ENABLE_FAILED | Failed to enable the license. |
FLY_SAFE_LICENSE_ENABLE_USER_ID_ERROR | Cannot enable the license because of user ID error. |
FLY_SAFE_LICENSE_NOT_EXIST | The license does not exist. |
FLY_SAFE_NO_LICENSE_DATA | The license does not contain data. |
FLY_SAFE_LOW_FIRMWARE_VERSION_ERROR | The firmware version is too old. |
FLY_SAFE_UNLOCK_VERSION_ERROR | Unlock version error. |
FLY_SAFE_OLD_LICENSE_DATA_ERROR | The license is out-of-date. |
FLY_SAFE_INVALID_KEY_VERSION | Key version error. |
FLY_SAFE_NO_LICENSE_ID | The license ID does not exist. |
FLY_SAFE_SERVER_INVALID_TOKEN | Used invalid token. |
FLY_SAFE_SERVER_UNIDENTIFIED_PHONE | The phone number is not identified by the server. |
FLY_SAFE_SERVER_NOT_UNLOCKABLE_AREA | The area cannot be unlocked. |
FLY_SAFE_SERVER_UNLOCK_TO_MANY_AREAS | The request is rejected by the server because the user is trying to unlock too many areas at the same time. |
FLY_SAFE_SERVER_TOO_MANY_LICENSES | The request is rejected by the server because there are too many licenses. |
FLY_SAFE_SERVER_JSON_DATA_PARSE_ERROR | The server failed to parse the JSON data. |
SDK_REGISTRATION_COULD_NOT_CONNECT_TO_INTERNET | The application is not able to connect to the Internet the first time it tries to register the key. |
SDK_REGISTRATION_INVALID_SDK_KEY | The application key you provided is incorrect. |
SDK_REGISTRATION_HTTP_TIMEOUT | The network you are trying to reach is busy, or the server is unreachable. |
SDK_REGISTRATION_DEVICE_DOES_NOT_MATCH | The attempt to copy data from another registered device to a device that is currently connected is not permitted. |
SDK_REGISTRATION_PACKAGE_ID_DOES_NOT_MATCH | The package ID of your application does not match the one you registered on the developer website when you applied to obtain an application key. |
SDK_REGISTRATION_SDK_KEY_PROHIBITED | The application key is prohibited. This occurs when an application key taht has already been released by DJI is revoked. |
SDK_REGISTRATION_MAX_REGISTRATION_COUNT_REACHED | Deprecated. |
SDK_REGISTRATION_SDK_KEY_INVALID_PLATFORM | This error occurs when an application key was given for a specific platform and is trying to be used to activate an application for another platform. |
SDK_REGISTRATION_SDK_KEY_DOES_NOT_EXIST | The application key does not exist. Please make sure the application key is correct. |
SDK_REGISTRATION_SDK_KEY_LEVEL_NOT_PERMITTED | Deprecated. |
SDK_REGISTRATION_SERVER_PARSE_FAILURE | The server failed to parse the request data. |
SDK_REGISTRATION_SERVER_WRITE_ERROR | Write error occurs in the server. |
SDK_REGISTRATION_SERVER_DATA_ABNORMAL | The data returned by the server is abnormal. |
SDK_REGISTRATION_INVALID_META_DATA | The respond for the REGISTRATION is in invalid format. |
SDK_REGISTRATION_EMPTY_SDK_KEY | The APP key is empty. |
SDK_REGISTRATION_VERSION_NOT_ACCESSIBLE | The SDK version is not accessible with the APP key. |
SDK_REGISTRATION_OVER_MAX_REGISTRATION_COUNT | Applications under basic develop account could only have the maximum 20 unqiue REGISTRATIONs. Visit DJI Developer Center to upgrade the membership. |
ACCOUNT_MANAGER_AUTHROIZED_FAILED | Authorization failed during login. |
ACCOUNT_MANAGER_NETWORK_REQUEST_ERROR | The network request encountered errors. |
PLACEHOLDER | Placeholder for errors that not handled by SDK. |
PLAYBACK_START_STOP_FETCH_COMPLETED | Stoppoing fetching is completed. |
ACCESS_LOCKER_INVALID_STATE | Access locker is in invalid state. |
MEDIA_TASK_ABORT | The task is aborted. |
TRANSFER_NOT_EXIST | Transferring doesn’t exist. |
ACCESS_LOCKER_USERNAME_NOT_EXIST | The username of access locker doesn’t exist. |
ACCESS_LOCKER_FIRMWARE_READ | Reading error of access locker. |
MEDIA_CANCEL_TASK_NOT_EXIST | Task doesn’t exist. |
PLAYBACK_FILE_LIST_RESET | File list is reset. |
ACCESS_LOCKER_SECURITYCODE_INCORRECT_FIVETIMES | Input incorrect security code for five times. |
FILE_LIST_NOT_EXIST | File list is not exist. |
FILE_LIST_INVOKE_RELOAD | File list needs to be reloaded. |
ACCESS_LOCKER_ALREADY_UNLOCKED | Access locker is already unlocked. |
ACCESS_LOCKER_FIRMWARE_WRITE | Writing of access locker. |
DOWNLOAD_DATA_PARSING_FAILURE | Failed when parsing downloaded data. |
FILE_LIST_UPDATE_ERROR | Failed while updating file list. |
PLAYBACK_START_STOP_FETCH_BUSY | On progress fetching or deleting file list. |
ACCESS_LOCKER_SECURITYCODE_INCORRECT | Security code is incorrect. |
MEDIA_TASK_SYNC_FAILURE | Failed while syncing media task. |
ACCESS_LOCKER_SECURITYCODE_INCORRECT_TWENTYTIMES | Input incorrect security code for twenty times. |
ACCESS_LOCKER_SECURITYCODE_FORMAT_INVALID | The format of access locker’s security code is invalid. |
ACCESS_LOCKER_NOT_SETUP | Access locker is not set up. |
DOWNLOADED_EMPTY_DATA | The downloaded data is empty. |
TRANSCODE_ERROR | Error of transcoding. |
DOWNLOAD_ABORT_BY_FIRMWARE | The download process is aborted by firmware. |
MEDIA_TASK_CANCEL | The media task is cancelled. |
UNKNOWN | Unknown error. |
enum SDKRegistrationState
enum SDKRegistrationState
Declaration: | DJI.WindowsSDK |
---|---|
Description:
States related to SDK registration.
与SDK注册相关的州。
Enum Members:
PendingForNetwork | The registration is pending for network connection. |
---|---|
Failed | The registration failed. Check the resultCode for the failure reason. |
Succeeded | The registration succeeded. |
Unknown | Unknown. |
struct EmptyMsg
struct EmptyMsg
Declaration: | DJI.WindowsSDK |
---|---|
Description:
A class that contains no property. It is not used by SDK yet.
不包含任何属性的类。SDK还没有使用它。
struct DoubleMsg
struct DoubleMsg
Declaration: | DJI.WindowsSDK |
---|---|
Description:
A class that contains a double value.
Struct Members:
double value | The actual value of the class. |
---|---|
struct IntMsg
struct IntMsg
Declaration: | DJI.WindowsSDK |
---|---|
Description:
A class that contains an int value.
Struct Members:
int value | The actual value of the class. |
---|---|
struct StringMsg
struct StringMsg
Declaration: | DJI.WindowsSDK |
---|---|
Description:
A class that contains a string value.
Struct Members:
String value | The actual value of the class. |
---|---|
struct BoolMsg
struct BoolMsg
Declaration: | DJI.WindowsSDK |
---|---|
Description:
A class that contains a string value.
Struct Members:
bool value | The actual value of the class. |
---|---|
struct DoubleMinMax
struct DoubleMinMax
Declaration: | DJI.WindowsSDK |
---|---|
Description:
A struct to represent a min and max range in double type.
Struct Members:
double min | The minimum value of the range. |
---|---|
double max | The maximum value of the range. |
struct LocationCoordinate2D
struct LocationCoordinate2D
Declaration: | DJI.WindowsSDK |
---|---|
Description:
A geographical coodinate.
一个地理坐标。
Struct Members:
double latitude | The latitude in degree. |
---|---|
double longitude | The longitude in degree. |
struct Attitude
struct Attitude
Declaration: | DJI.WindowsSDK |
---|---|
Description:
An attitude value in three dimensions (pitch, roll and yaw)
Struct Members:
double pitch | The attitude value in the pitch dimension. |
---|---|
double roll | The attitude value in the roll dimension. |
double yaw | The attitude value in the yaw dimension. |
struct IntPoint2D
struct IntPoint2D
Declaration: | DJI.WindowsSDK |
---|---|
Description:
A class that contains x and y in int value, representing a point on a 2D space.
包含x和y的int值的类,表示二维空间中的一个点。
Struct Members:
int x | The x value of the 2D point. |
---|---|
int y | The y value of the 2D point. |
struct DoublePoint2D
struct DoublePoint2D
Declaration: | DJI.WindowsSDK |
---|---|
Description:
A class that contains x and y in double value, representing a point on a 2D space.
Struct Members:
double x | The x value of the 2D point. |
---|---|
double y | The y value of the 2D point. |
struct IntVector2D
struct IntVector2D
Declaration: | DJI.WindowsSDK |
---|---|
Description:
A class that contains x and y in int value, representing a vector on a 2D space.
Struct Members:
int x | The x value of the vector. |
---|---|
int y | The y value of the vector. |
struct Velocity3D
struct Velocity3D
Declaration: | DJI.WindowsSDK |
---|---|
Description:
A velocity value in three dimensions (x, y and z). The coordinate may have different meanings in different scenarios.
三维(x, y, z)的速度值。在不同的情况下,坐标可能有不同的含义。
Struct Members:
double x | The velocity value in x dimension. |
---|---|
double y | The velocity value in y dimension. |
double z | The velocity value in z dimension. |
struct DoublePoint3D
struct DoublePoint3D
Declaration: | DJI.WindowsSDK |
---|---|
Description:
A class that contains x, y and z in double value, representing a point on a 3D space.
包含x、y和z的双精度类,表示三维空间中的一个点。
Struct Members:
double x | The x value of the 3D point. |
---|---|
double y | The y value of the 3D point. |
double z | The z value of the 3D point. |
struct IntMinMax
struct IntMinMax
Declaration: | DJI.WindowsSDK |
---|---|
Description:
A struct to represent a min and max range in double type.
在双类型中表示最小和最大范围的结构。
Struct Members:
int min | The minimum value of the range. |
---|---|
int max | The maximum value of the range. |
struct DateTime
struct DateTime
Declaration: | DJI.WindowsSDK |
---|---|
Description:
A class that represents the date time.
Struct Members:
int day | Day. |
---|---|
int minute | Minute. |
int year | Year. |
int second | Second. |
int month | Month. |
int hour | Hour. |
struct ResultValue
struct ResultValue<T>
Declaration: | DJI.WindowsSDK |
---|---|
Description:
A generic class that encapsulates the execution result of a request.
封装请求执行结果的泛型类。
Struct Members:
SDKError error | The encountered error if any. It is NO_ERROR if the request succeeds. |
---|---|
T value | The execution result value. It is null if the request fails. |
method ~DJISDKManager
~DJISDKManager()
Declaration: | DJI.WindowsSDK |
---|---|
Description:
Destructor. It should not be called explicitly.
delegate IntVector2DChangedEventHandler
delegate void IntVector2DChangedEventHandler(object sender, IntVector2D? value)
Declaration: | DJI.WindowsSDK |
---|---|
Description:
A delegate type used to subscribe the updated values in type IntVector2D
.
用于订阅类型’ IntVector2D '中的更新值的委托类型。
delegate LocationCoordinate2DChangedEventHandler
delegate void LocationCoordinate2DChangedEventHandler(object sender, LocationCoordinate2D? value)
Declaration: | DJI.WindowsSDK |
---|---|
Description:
A delegate type used to subscribe the updated values in type LocationCoordinate2D
.
用于订阅类型’ LocationCoordinate2D '中的更新值的委托类型。
delegate BoolMsgChangedEventHandler
delegate void BoolMsgChangedEventHandler(object sender, BoolMsg? value)
Declaration: | DJI.WindowsSDK |
---|---|
Description:
A delegate type used to subscribe the updated values in type BoolMsg
.
用于订阅类型“BoolMsg”中已更新的值的委托类型。
delegate StringMsgChangedEventHandler
delegate void StringMsgChangedEventHandler(object sender, StringMsg? value)
Declaration: | DJI.WindowsSDK |
---|---|
Description:
A delegate type used to subscribe the updated values in type StringMsg
.
用于订阅类型“StringMsg”中的更新值的委托类型。
delegate Velocity3DChangedEventHandler
delegate void Velocity3DChangedEventHandler(object sender, Velocity3D? value)
Declaration: | DJI.WindowsSDK |
---|---|
Description:
A delegate type used to subscribe the updated values in type Velocity3D
.
delegate DoubleMsgChangedEventHandler
delegate void DoubleMsgChangedEventHandler(object sender, DoubleMsg? value)
Declaration: | DJI.WindowsSDK |
---|---|
Description:
A delegate type used to subscribe the updated values in type DoubleMsg
.
delegate IntMsgChangedEventHandler
delegate void IntMsgChangedEventHandler(object sender, IntMsg? value)
Declaration: | DJI.WindowsSDK |
---|---|
Description:
A delegate type used to subscribe the updated values in type IntMsg
.
delegate DoublePoint2DChangedEventHandler
delegate void DoublePoint2DChangedEventHandler(object sender, DoublePoint2D? value)
Declaration: | DJI.WindowsSDK |
---|---|
Description:
A delegate type used to subscribe the updated values in type DoublePoint2D
.
delegate AttitudeChangedEventHandler
delegate void AttitudeChangedEventHandler(object sender, Attitude? value)
Declaration: | DJI.WindowsSDK |
---|---|
Description:
A delegate type used to subscribe the updated values in type Attitude
.
delegate IntPoint2DChangedEventHandler
delegate void IntPoint2DChangedEventHandler(object sender, IntPoint2D? value)
Declaration: | DJI.WindowsSDK |
---|---|
Description:
A delegate type used to subscribe the updated values in type IntPoint2D
.
delegate SDKRegistrationStateChangedEventHandler
delegate void SDKRegistrationStateChangedEventHandler(SDKRegistrationState state, SDKError errorCode)
Declaration: | DJI.WindowsSDK |
---|---|
Description:
Delegate type that use to subscribe the SDK registration state and error code if there is any error.
event SDKRegistrationStateChanged
event SDKRegistrationStateChangedEventHandler SDKRegistrationStateChanged
Declaration: | DJI.WindowsSDK |
---|---|
Description:
Subscribe the event to receive the change of SDK registration state.
property Instance
static DJISDKManager Instance { get; }
Declaration: | DJI.WindowsSDK |
---|---|
Description:
The single instance of DJISDKManager
. Use it as entry for all features of SDK. This class is accessible before SDK registration.
DJISDKManager的单个实例。使用它作为SDK的所有特性的入口。在SDK注册之前可以访问这个类。
property SDKVersion
static string SDKVersion { get; }
Declaration: | DJI.WindowsSDK |
---|---|
Description:
Gets the DJI Windows SDK version. Returns SDK version as a string.
获取DJI Windows SDK版本。以字符串形式返回SDK版本。
property VideoFeeder
VideoFeeder VideoFeeder { get; }
Declaration: | DJI.WindowsSDK |
---|---|
Description:
Accesses to the video feeder, which provides the video feeds.
访问提供视频馈线的视频馈线。
property ComponentManager
ComponentManager ComponentManager { get; }
Declaration: | DJI.WindowsSDK |
---|---|
Description:
Accesses to the component manager, which is the entry of different components (flight controllers, cameras, etc.).
访问组件管理器,它是不同组件(飞行控制器、相机等)的入口。
property VirtualRemoteController
VirtualRemoteController VirtualRemoteController { get; }
Declaration: | DJI.WindowsSDK |
---|---|
Description:
Accesses to the virtual remote controller. It is used to control the aircraft’s attitude when SDK is connected to the aircraft through WiFi without any physical remote controller.
访问虚拟遥控器。当SDK通过WiFi连接到飞行器时,用于控制飞行器的姿态,不需要任何物理遥控器。
property FlyZoneManager
FlyZoneManager FlyZoneManager { get; }
Declaration: | DJI.WindowsSDK |
---|---|
Description:
Accesses to the fly-zone manager. It is the entry of functionality related to DJI’s GEO system.
进入飞行区管理器。它是与DJI的GEO系统相关的功能入口。
property UserAccountManager
UserAccountManager UserAccountManager { get; }
Declaration: | DJI.WindowsSDK |
---|---|
Description:
Accesses to the user account manager. Login is required to access some features in fly-zone.
访问用户帐户管理器。需要登录才能访问飞行地带的一些功能。
property WaypointMissionManager
WaypointMissionManager WaypointMissionManager { get; }
Declaration: | DJI.WindowsSDK |
---|---|
Description:
Accesses to the waypoint mission manager.
method RegisterApp
void RegisterApp(string key)
Declaration: | DJI.WindowsSDK |
---|---|
Description:
The first time the app is initialized after installation, the app connects to a DJI Server through the internet to verify the Application Key. The request will include the following information:
-
App key
-
Package ID
-
System platform, version and name
-
UUID generated by platform’s API (
EasClientDeviceInformation.Id
) -
System version Subsequent app starts will use locally cached verification information to register the app when the cached information is still valid.
-
app安装后第一次初始化,app通过互联网连接到DJI服务器,验证应用程序密钥。该要求将包括以下资料:
——应用关键
——包ID
-系统平台、版本和名称
-由平台的API生成的UUID (’ easclientdeviceinfo . id ')
-系统版本后续应用程序启动时,当缓存信息仍然有效时,将使用本地缓存的验证信息注册应用程序。
Input Parameters:
string key | The key used to register SDK for the application. This can be applied in DJI Develop Center. |
---|---|
property SDKRegistrationResultCode
SDKError SDKRegistrationResultCode { get; }
Declaration: | DJI.WindowsSDK |
---|---|
Description:
Determines if SDK is registered. This is the pre-condition of using most of the features in SDK.
确定SDK是否注册。这是使用SDK中大多数特性的前提条件。
method EnableDebugLogSystem
bool EnableDebugLogSystem()
Declaration: | DJI.WindowsSDK |
---|---|
Description:
Enables the debug log system. It will enable the DJI Windows SDK to collect logs that are related to the SDK’s internal logic. These logs can be used to help diagnose SDK bugs. The debug log system is disabled by default. The developer can call this method in each life cycle of the application to enable the log system. The logs will be saved to directory named logs. The logs are under the application’s local folder.
启用调试日志系统。它将使DJI Windows SDK能够收集与SDK内部逻辑相关的日志。这些日志可用于帮助诊断SDK bug。默认情况下,调试日志系统是禁用的。开发人员可以在应用程序的每个生命周期中调用此方法来启用日志系统。这些日志将保存到名为logs的目录中。日志位于应用程序的本地文件夹下。
Return:
bool | Return true if SDK has been registered. |
---|---|
method DisableDebugLogSystem
bool DisableDebugLogSystem()
Declaration: | DJI.WindowsSDK |
---|---|
Description:
Disables the debug log system.
Return:
bool | Return true if SDK has been registered. |
---|---|
class FlyZoneManager
Declaration: | DJI.WindowsSDK.FlySafe |
---|---|
sealed class FlyZoneManager
- 飞行地区管理,该类提供对飞行地区程序的访问。
GetFlyZoneHandler
- 获取FlyZoneHandler对应的带有产品索引的对象。
Input Parameters:
uint productIndex | 连接产品的索引 |
---|---|
Return:
FlyZoneHandler | Return FlyZoneHandler object. |
---|---|
class FlyZoneHandler
Declaration: DJI.WindowsSDK.FlySafe
sealed class FlyZoneHandler
飞行区域处理程序提供附近飞行区域的信息,和api解锁区域,可以解锁。根据地点的不同,有三种可能的飞行区域:
-
圆:圆柱体或截锥体积,有四层限制:
警戒区:无限制
增强警戒区:飞行受限,可在用户登录DJI账户时解锁飞行
授权区域:飞行受限,可在用户登录DJI账号后解锁飞行,且该账号已被授权解锁授权区域。
禁区:飞行受限
-
多边形:由一个或多个圆柱体或具有不同高度限制的复杂体组成的飞行区域。高度限制为0表示飞行完全受限。
method GetFlyZonesInSurroundArea
async Task<ResultValue<List<FlyZoneInformation>>> GetFlyZonesInSurroundArea()
Description:
得到飞机10公里内的所有飞行区域。
Return:
async Task<ResultValue<List<FlyZoneInformation>>> | 如果操作没有错误的话,返回飞机周围的飞行区域信息。当飞机周围没有飞行区域时,该信息可能为空。 |
---|---|
method GetUnlockedFlyZonesForAircraft
async Task<ResultValue<List<FlyZoneInformation>>> GetUnlockedFlyZonesForAircraft()
Description:
获取由帐户为已连接的飞机解锁的授权飞行区域列表。它包括由飞行计划者(http://www.dji.com/flysafe/geo-system# Planner)解锁的飞行区域,以及使用DJI Go或任何基于DJI Mobile/Windows SDK的应用程序在飞行期间解锁的飞行区域。此列表不包括通过自定义解锁解锁的飞行区域。
Return:
async Task<ResultValue<List<FlyZoneInformation>>> | 如果操作无误,飞行器上已解锁的飞行区域信息。当飞机上没有未解锁的飞行区域时,该信息可能为null |
---|---|
method UnlockFlyZones
async Task<SDKError> UnlockFlyZones(List<uint> flyZoneIDs)
Description:
解锁选定的飞行区域。此方法可用于解锁授权区域。在解锁区域后,飞行将不受限制,直到解锁到期。解锁记录将链接到用户的帐户,DJI Go和其他基于DJI Mobile/Windows SDK的应用程序可以访问该记录。
数据保护注意事项-调用此方法将发送以下受保护的数据到DJI服务器:
-用户帐户信息
-相连飞机的序列号。
Input Parameters:
List<uint> flyZoneIDs | The IDs of AuthorizedWarningZones. |
---|---|
Return:
async Task<SDKError> | The operation error code. |
---|---|
method SetUnlockingEnabled
async Task<SDKError> SetUnlockingEnabled(FlyZoneInformation flyZone, bool enabled)
Description:
将启用状态设置为飞机上选定的授权飞行区域。此方法可用于设置飞机上当前特定授权飞行区域的启用状态。飞机上的所有授权飞行区域都可以通过“getunlockedflyonesforaircraft”获得。
Input Parameters:
FlyZoneInformation flyZone | 要启用的飞行区域 |
---|---|
bool enabled | 飞机上的启用状态设置为授权飞行区域 |
Return:
async Task<SDKError> | The operation error code. |
---|---|
method GetUnlockingEnabled
async Task<ResultValue<bool>> GetUnlockingEnabled(FlyZoneInformation flyZone)
Description:
获取飞机上所选授权飞行区的启用状态。飞机上的所有授权飞行区域都可以通过“getunlockedflyonesforaircraft”获得。
Input Parameters:
FlyZoneInformation flyZone | 获取飞机上所选授权飞行区域的启用状态 |
---|---|
Return:
async Task<ResultValue<bool>> | 飞机上所选授权飞行区域的启用状态。如果在飞机上找不到所选的授权飞行区域,将返回未知的操作错误代码。 |
---|---|
method ReloadUnlockedZoneGroupsFromServer
async Task<SDKError> ReloadUnlockedZoneGroupsFromServer()
Description:
从服务器重新加载由当前用户的帐户解锁的已解锁区域组。对于所有产品,这包括自解锁和自定义解锁区域。每个未上锁的区域组对应一个飞机序列号。启动后,SDK将调用此方法一次。当网络连接或当前帐户状态发生变化时(例如,当新用户成功登录时),它将再次调用此方法。其他任何时候都可以调用此方法来手动触发重新加载。调用此方法不会将加载的区域组同步到飞机上。要获取当前从服务器加载的组列表,调用’ GetLoadedUnlockedZoneGroups '。用户需要手动调用“SyncUnlockedZoneGroupToAircraft”来在未解锁的区域组重新加载后将未解锁的组同步到已连接的飞机。
Return:
async Task<SDKError> | The operation error code. |
---|---|
method GetCustomUnlockZonesFromAircraft
async Task<ResultValue<List<CustomUnlockZone>>> GetCustomUnlockZonesFromAircraft()
Description:
获取当前在飞机上的自定义解锁区域。
Return:
async Task<ResultValue<List<CustomUnlockZone>>> | 自定义在飞机上解锁区域。当出现错误或飞机上没有自定义解锁区域时,结果将为null。 |
---|---|
method EnableCustomUnlockZone
async Task<SDKError> EnableCustomUnlockZone(CustomUnlockZone customUnlockZone)
Description:
启用在飞机上的自定义解锁区域。飞机上所有的自定义解锁区域都可以通过“GetCustomUnlockZonesFromAircraft”获得。在任何时候,只有一个自定义解锁区域可以启用。启用自定义解锁区域将禁用之前启用的区域。
Input Parameters:
CustomUnlockZone customUnlockZone | 自定义解锁区域启用 |
---|---|
Return:
async Task<SDKError> | The operation error code. |
---|---|
method DisableCustomUnlockZone
async Task<SDKError> DisableCustomUnlockZone()
Description:
禁用当前飞机上的自定义解锁区域(如果有的话)。当前启用的自定义解锁区域可以通过“GetEnabledCustomUnlockZone”来获取。
Return:
async Task<SDKError> | The operation error code. |
---|---|
method GetEnabledCustomUnlockZone
async Task<ResultValue<CustomUnlockZone>> GetEnabledCustomUnlockZone()
Return:
async Task<ResultValue<CustomUnlockZone>> | 飞机上当前启用的自定义解锁区域。当出现错误或飞机上没有启用自定义解锁区域时,结果将为null |
---|---|
method GetLoadedUnlockedZoneGroups
async Task<ResultValue<List<UnlockZoneGroup>>> GetLoadedUnlockedZoneGroups()
Description:
获取从服务器加载的未锁定区域组。每个区域组对应一架飞机。装载区域组不会自动与飞机同步。用户需要手动调用’ SyncUnlockedZoneGroupToAircraft '来同步未解锁的区域