Oracle VM VirtualBox 6.1.30 Programming Guide and Reference

• 语言: 英语
• 格式: .pdf
• 来源: download.virtualbox.org

摘要

文档详细介绍了Oracle VM VirtualBox 6.1.30的编程接口，包括WebService和COM/XPCOM的使用方法，以及如何通过不同语言（如Java、Python、PHP）调用API。文档还涵盖了虚拟机的基本配置、启动、云集成、HGCM通信管理、RDP控件等内容，并提供了详细的API变化日志，说明了不同版本间的不兼容变化。

AI总结

《Oracle VM VirtualBox 6.1.30 编程指南与参考资料》总结：

### 1. **简介**
- **模块化设计**：VirtualBox 的核心 API（Main API）是模块化的，支持多种接口方式。
- **Main API 的实现**：
- **WebService**：通过 SOAP 接口实现，支持多种语言（Java、Python、PHP、Perl 等）。
- **COM/XPCOM**：在 Windows 上使用 COM，在其他平台使用 XPCOM。
- **WebService 的两种使用方式**：
- **OOWS（面向对象WebService）**：提供 OO 层，简化 Java 和 Python 的使用。
- **Raw WebService**：直接使用 WSDL，适用于其他语言。
- **内部实现**：VirtualBox 的前端（GUI 和 CLI）均基于 Main API。

### 2. **环境特定说明**
- **OOWS 支持**：
- Java：通过 OO 绑定实现。
- Python：提供 OO 层，简化调用。
- PHP：支持 OOWS。
- **Raw WebService**：适用于无 OO 绑定的语言，需依赖 WSDL 工具。
- **COM/XPCOM 直接使用**：
- Python、Java 等语言可直接调用。
- 提供 C 绑定，支持跨平台开发（Windows、Linux、MacOS、Solaris）。
- **事件队列处理**：需在主线程定期处理事件，避免阻塞。
- **VBS 和 Visual Basic**：支持通过 COM 调用 Main API。

### 3. **基本 VirtualBox 概念**
- **虚拟机信息**：获取和修改虚拟机属性。
- **会话管理**：通过会话 API 修改虚拟机设置。
- **虚拟机启动**：支持启动和控制虚拟机。
- **事件处理**：定义了虚拟机事件接口，便于监控和处理事件。

### 4. **与云集成**
- **OCI 功能**：支持 Oracle 云集成。
- **主要函数**：
- `ICloudClient::exportVM`：导出虚拟机。
- `ICloudClient::launchVM`：启动虚拟机。
- `ICloudClient::importInstance`：导入实例。

### 5. **主机- guest 通信管理器**
- **协议规范**：
- 请求头：定义通信参数。
- Connect/Disconnect：建立和断开连接。
- Call32/Call64：处理 32/64 位调用。
- Cancel：取消操作。
- **Guest 软件接口**：
- Guest 驾驶员接口：实现主机与 guest 的通信。
- Guest 应用程序接口：提供给 guest 程序调用。

### 6. **RDP Web 控制**
- **功能**：支持将 RDP 集成到网页，便于远程访问。
- **参考**：提供详细的 RDPWeb 函数和嵌入方式。
- **变更日志**：记录不同版本的更新内容。

### 7. **拖放功能**
- **基本概念**：支持文件和数据在主机与 guest 之间的拖放操作。
- **支持格式**：包括常见的文件格式和剪贴板数据。

### 8. **外部认证模块**
- **功能**：支持外部认证模块，增强安全性。

### 9. **Java API 使用**
- **要求**：需安装 Java 环境。
- **示例**：提供简单示例，展示如何调用 VirtualBox API。

### 10. **许可信息**
- **LGPL 2.1**：部分代码遵循 LGPL 协议，需遵守相关条款。

### 11. **主要 API 变更日志**
- **版本兼容性**：保持主版本内的 API 兼容性。
- **不兼容变更**：
- **6.1 版本**：将图形适配器接口拆分为 `IGraphicsAdapter`。
- **6.0 版本**：
- 视频录制 API 移动到 `IRecordingSettings` 和 `IRecordingScreenSettings`。
- 重命名 `IVideoCaptureChangedEvent` 为 `IRecordingChangedEvent`。
- **其他版本**：记录了从 2.0 到 6.1 的所有不兼容变更，便于迁移。

### 总结
《Oracle VM VirtualBox 6.1.30 编程指南与参考资料》全面介绍了 VirtualBox 的编程接口、实现方式及使用方法。主要内容包括：
- **API 设计**：模块化、跨平台支持。
- **WebService 和 COM/XPCOM**：提供多种调用方式。
- **云集成和事件处理**：增强功能。
- **版本兼容性**：详细记录 API 变更，便于开发和迁移。