2 概览（Overview）

---

2.1 EDSDK 的功能概述（Functions of EDSDK）

## 2.1 EDSDK 的功能概述（Functions of EDSDK）

EDSDK 主要提供以下功能：

- 连接并控制 Canon 数码相机
- 控制相机的拍摄操作
- 设置和获取相机属性
- 获取相机状态
- 下载相机中保存的图像文件
- 接收并处理来自相机的事件通知

---

2.2 远程连接协议（Remote Connection Protocol）

## 2.2 远程连接协议（Remote Connection Protocol）

EDSDK 使用 PTP（Picture Transfer Protocol，图片传输协议） 与相机进行通信。

- PTP 是一种标准化的图像设备通信协议
- Canon 在标准 PTP 的基础上扩展了专有命令
- EDSDK 封装了这些 Canon 扩展命令，供应用程序调用

通过 EDSDK，开发者无需直接实现 PTP 协议，即可控制相机并访问其数据。

---

2.3 系统结构（System Architecture）

## 2.3 系统结构（System Architecture）

EDSDK 系统结构由以下组件构成：

- 应用程序（Client Application）
- EDSDK 库
- 操作系统的设备驱动
- Canon 数码相机

工作流程说明

1. 应用程序调用 EDSDK API
2. EDSDK 将 API 请求转换为相机可识别的命令
3. 命令通过操作系统和设备驱动发送至相机
4. 相机返回结果
5. EDSDK 将结果转换为 API 返回值并返回给应用程序

---

2.4 EDSDK 的对象模型（Object Model）

## 2.4 EDSDK 的对象模型（Object Model）

EDSDK 采用 对象模型（Object-Oriented Model） 来表示相机及其资源。

EDSDK 中的所有资源都以"对象"的形式进行管理，
并通过句柄（Handle）在应用程序中进行访问。

主要对象类型

- 相机对象（Camera）
- 卷对象（Volume）
- 文件夹对象（Directory）
- 文件对象（File）
- 流对象（Stream）

所有对象都继承自 EdsBaseRef 类型。

---

2.5 会话管理（Session Management）

## 2.5 会话管理（Session Management）

在使用 EDSDK 控制相机之前，必须先打开一个 会话（Session）。

基本流程如下：

1. 获取相机对象
2. 调用 `EdsOpenSession` 打开会话
3. 通过会话控制相机
4. 调用 `EdsCloseSession` 关闭会话

注意：

• 同一时间只能有一个会话与相机保持连接
• 如果会话未正确关闭，可能导致相机无法再次连接

---

2.6 事件处理（Event Handling）

## 2.6 事件处理（Event Handling）

EDSDK 提供了事件通知机制，用于通知应用程序相机状态的变化。

事件类型

- 对象事件（Object Event）
- 属性事件（Property Event）
- 状态事件（State Event）

事件处理方式

- 应用程序需要注册回调函数
- 当事件发生时，EDSDK 会调用对应的回调函数
- 应用程序在回调中处理相应逻辑

---

2.7 错误处理（Error Handling）

## 2.7 错误处理（Error Handling）

EDSDK 的所有 API 都会返回一个 错误码（EdsError）。

- 返回值为 `EDS_ERR_OK` 表示调用成功
- 其他返回值表示发生错误

应用程序必须检查每一次 API 调用的返回值，以确保程序的稳定性。