DJITelloPy 项目使用教程

DJITelloPy 项目使用教程

DJITelloPy DJI Tello drone python interface using the official Tello SDK. Feel free to contribute! 项目地址: https://gitcode.com/gh_mirrors/dj/DJITelloPy

1. 项目目录结构及介绍

DJITelloPy 项目是一个用于控制 DJI Tello 无人机的 Python 接口库，项目目录结构如下：

DJITelloPy/
├── djitellopy/             # 核心库代码目录
├── docs/                  # 文档目录
├── examples/              # 示例代码目录
├── .gitignore             # Git 忽略文件
├── README.md              # 项目说明文件
├── README_CN.md           # 项目说明文件（中文版）
├── doc-requirements.txt   # 文档依赖项
├── mkdocs.yml             # MkDocs 配置文件
├── requirements.txt       # 项目依赖项
├── setup.cfg              # 设置配置文件
└── setup.py               # 项目安装脚本

核心目录和文件说明：

• djitellopy/：包含项目的所有 Python 代码，包括类定义和方法实现。
• docs/：存放项目的文档资料，通常包含 API 参考和教程。
• examples/：包含使用 DJITelloPy 的示例代码，用于展示如何控制和操作无人机。
• requirements.txt：列出项目运行所需的 Python 包依赖。
• setup.py：包含项目的元数据和安装脚本，用于通过 pip 安装库。

2. 项目的启动文件介绍

DJITelloPy 项目的启动通常是通过在 djitellopy 目录下运行 Python 代码来实现的。以下是一个简单的启动文件示例，它展示了如何创建一个 Tello 对象并执行基本操作：

# main.py
from djitellopy import Tello

# 创建 Tello 对象
tello = Tello()

# 连接至无人机
tello.connect()

# 起飞
tello.takeoff()

# 向左移动 100 像素
tello.move_left(100)

# 逆时针旋转 90 度
tello.rotate_counter_clockwise(90)

# 向前移动 100 像素
tello.move_forward(100)

# 着陆
tello.land()

# 断开连接
tello.disconnect()

要运行上述代码，需要在命令行中执行以下命令：

python main.py

确保已经安装了 DJITelloPy 库以及所有依赖。

3. 项目的配置文件介绍

DJITelloPy 项目的配置主要通过 setup.py 和 requirements.txt 这两个文件来管理。

• setup.py：此文件定义了项目的名称、版本、描述、作者、依赖项等信息。以下是一个简化版的 setup.py 文件内容：

from setuptools import setup, find_packages

setup(
    name='DJITelloPy',
    version='2.5',
    description='DJI Tello drone python interface using the official Tello SDK',
    author='Damià Fuentes Escoté',
    packages=find_packages(),
    install_requires=[
        'numpy'
    ]
)

• requirements.txt：此文件列出了项目运行所需的第三方 Python 包，如下所示：

numpy

这些配置文件确保了项目可以正确安装和运行所需的依赖，同时也方便其他开发者了解和使用项目。

DJITelloPy DJI Tello drone python interface using the official Tello SDK. Feel free to contribute! 项目地址: https://gitcode.com/gh_mirrors/dj/DJITelloPy