Oracle VM VirtualBox 7.0.2 Programming Guide and Reference

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

摘要

文档详细介绍了Oracle VM VirtualBox的编程接口（Main API），包括如何通过WebService、COM/XPCOM以及不同编程语言（如Java、Python、PHP、C等）访问和使用该API。文档还列出了自版本2.2以来的重大API变更，包括音频适配器的移动、机器打开时密码参数的添加、默认音频驱动的更改、主机更新功能的重构、目录复制功能的更改以及事件类型的重命名。文档提供了如何使用这些接口的示例和详细说明，适用于开发者进行虚拟机管理、配置和控制。

AI总结

《Oracle VM VirtualBox 7.0.2 Programming Guide and Reference》提供了关于VirtualBox编程接口（Main API）的详细文档，涵盖了使用COM/XPCOM、WebService以及不同编程语言的绑定方式。以下是文档的核心内容总结：

### 1. 主要功能与接口
- **主API**：VirtualBox的Main API允许开发者创建、配置、启动、停止和删除虚拟机，获取性能统计信息，以及管理虚拟机设置。该API在所有平台上保持一致，并通过COM/XPCOM、WebService或编程语言绑定的方式实现。
- **模块化设计**：VirtualBox分为多个模块，包括底层的虚拟化引擎（hypervisor）、设备驱动、用户空间服务（如RDP服务器）和API层，便于开发者扩展和集成。

### 2. 主要接口与功能
- **音频适配器**：音频功能通过新的`IAudioSettings`接口管理，支持设置音频控制器类型、输入/输出状态等。
- **虚拟机操作**：支持创建、启动、停止虚拟机，获取机器信息，修改设置，以及导出/导入虚拟机配置。
- **事件处理**：通过COM/XPCOM或WebService接口，开发者可以订阅和处理虚拟机事件（如启动、关闭、状态变化等）。

### 3. API变化日志
- **版本7.0不兼容更改**：
- 音频适配器功能移动到新的`IAudioSettings`接口。
- `IVirtualBox::openMachine`方法新增密码参数。
- 默认音频驱动改为`AudioDriverType_Default`，自动选择最适合当前主机的操作系统驱动。
- `IHost::update`方法被重构为`IHost::updateHost`，使用新的`IHostUpdateAgent`接口。
- `directoryCopyFromGuest`和`directoryCopyToGuest`方法不再默认递归复制或跟随符号链接，需使用新标志`DirectoryCopyFlag::Recursive`和`DirectoryCopyFlag::FollowLinks`。
- `VBoxEventType Last`重命名为`VBoxEventType End`。

- **版本6.1不兼容更改**：
- 将`IMachine`中的图形适配器功能移动到新的`IGraphicsAdapter`接口。

### 4. 使用方式
- **COM/XPCOM**：
- 支持多种语言，如Java、Python、Visual Basic、C++等。
- 通过COM/XPCOM接口可以直接访问VirtualBox的功能，适用于熟悉COM的开发者。

- **WebService**：
- 提供基于SOAP的WebService接口，适用于多种编程语言。
- 支持两种使用方式：
- **OOWS（Object-Oriented Web Service）**：提供Java、Python、PHP等语言的封装类，简化使用。
- **Raw WebService**：直接使用WebService接口，适用于支持WSDL的编程语言。

- **C语言绑定**：
- 提供跨平台的C语言绑定，支持Windows、Linux、MacOS和Solaris。
- 通过`VBoxCAPIGlue`库实现动态库加载，简化平台差异处理。

### 5. 示例与工具
- **VBS示例**：

  set vb = CreateObject("VirtualBox.VirtualBox")
  Wscript.Echo "VirtualBox version " & vb.version

该示例展示了如何获取VirtualBox版本信息。

- **VB示例**：

  Dim vb As VirtualBox.IVirtualBox
  vb = CreateObject("VirtualBox.VirtualBox")
  machines = ""
  For Each m In vb.Machines
      machines = machines & " " & m.Name
  Next

该示例展示了如何遍历所有虚拟机。

- **C语言示例**：
提供了`tstCAPIGlue.c`示例程序，演示如何使用C语言绑定初始化API、获取虚拟机列表、启动虚拟机、处理事件等。

### 6. 注意事项
- **兼容性**：主API在同一大版本（x.y.z中的x或y）内保持兼容，跨大版本时可能会有接口变化。
- **字符串与数组处理**：WebService客户端需注意字符串和数组的处理方式，确保代码在COM和XPCOM之间兼容。
- **内存管理**：使用COM/XPCOM时需注意对象的生命周期和引用计数，避免内存泄漏。

### 7. 总结
《Oracle VM VirtualBox 7.0.2 Programming Guide and Reference》为开发者提供了全面的API文档和示例，支持多种编程语言和接口方式（COM/XPCOM、WebService、C语言绑定）。通过该文档，开发者可以轻松集成VirtualBox功能到自定义应用中，并利用其强大功能进行虚拟机管理、配置和监控。