AudioDeviceCmdlets 使用与技术文档

1. 安装指南

AudioDeviceCmdlets 是一套用于控制 Windows 上音频设备的 PowerShell Cmdlets。安装前请确保以管理员身份运行 PowerShell。以下是安装步骤：

Install-Module -Name AudioDeviceCmdlets

2. 项目使用说明

该项目提供了一系列控制音频设备的 Cmdlets。以下是一些主要功能的示例：

• 获取所有音频设备列表：

Get-AudioDevice -List

• 获取默认播放和录音设备：

Get-AudioDevice -Playback
Get-AudioDevice -Recording

• 获取默认通信播放和录音设备：

Get-AudioDevice -PlaybackCommunication
Get-AudioDevice -RecordingCommunication

• 获取和设置默认设备的音量和静音状态：

Get-AudioDevice -PlaybackVolume
Set-AudioDevice -PlaybackVolume <float>
Get-AudioDevice -PlaybackMute
Set-AudioDevice -PlaybackMute <bool>

• 设置默认设备：

Set-AudioDevice <AudioDevice>

3. 项目API使用文档

以下是项目中一些关键 Cmdlets 的详细说明：

• Get-AudioDevice: 获取音频设备信息。

  参数：

  • -ID <string>: 通过设备 ID 获取指定设备。
  • -Index <int>: 通过设备索引获取指定设备。
  • -List: 获取所有已启用的设备列表。

• Set-AudioDevice: 设置默认音频设备。

  参数：

  • <AudioDevice>: 指定要设置为默认的音频设备。
  • -CommunicationOnly: 仅将设备设置为默认通信设备。
  • -DefaultOnly: 仅将设备设置为默认设备。

• Write-AudioDevice: 输出音频设备的功率输出。

  参数：

  • -PlaybackMeter: 输出默认播放设备的功率输出（仪表形式）。
  • -PlaybackStream: 输出默认播放设备的功率输出（数据流形式）。

4. 项目安装方式

若需要从源代码构建该项目，请遵循以下步骤：

1. 安装 Visual Studio 2022。
2. 创建新项目：文件 -> 新建 -> 从现有代码创建项目...。
   • 项目类型：Visual C#。
   • 文件夹：SOURCE。
   • 名称：AudioDeviceCmdlets。
   • 输出类型：类库。
3. 设置项目属性：项目 -> AudioDeviceCmdlets 属性。
   • 程序集名称：AudioDeviceCmdlets。
   • 目标框架：.NET Framework 4.6.1 或更高版本。
4. 安装 System.Management.Automation NuGet 包。
5. 设置解决方案配置为“发布”。
6. 构建 Cmdlet。
7. 将构建好的 DLL 文件导入 Windows PowerShell。

以上是关于 AudioDeviceCmdlets 项目的技术文档，希望对您有所帮助。