Microsoft Graph Communications Samples 项目教程

1. 项目的目录结构及介绍

microsoft-graph-comms-samples/
├── Samples/
│   ├── V1.0Samples/
│   │   ├── LocalMediaSamples/
│   │   │   ├── AudioVideoPlaybackBot/
│   │   │   └── ...
│   │   └── ...
│   └── ...
├── docs/
│   ├── README.md
│   └── ...
├── .gitignore
├── LICENSE
├── README.md
└── changelog.md

目录结构介绍

• Samples/: 包含项目的示例代码，分为不同的版本和类型。
  • V1.0Samples/: 包含V1.0版本的示例代码。
    • LocalMediaSamples/: 包含本地媒体相关的示例代码。
      • AudioVideoPlaybackBot/: 音频视频播放机器人的示例代码。
• docs/: 包含项目的文档文件，如README.md等。
• .gitignore: Git忽略文件，指定哪些文件或目录不需要被Git管理。
• LICENSE: 项目的许可证文件，通常为MIT许可证。
• README.md: 项目的介绍文件，包含项目的基本信息和使用说明。
• changelog.md: 项目的变更日志，记录项目的更新历史。

2. 项目的启动文件介绍

在 Samples/V1.0Samples/LocalMediaSamples/AudioVideoPlaybackBot/ 目录下，主要的启动文件是 Program.cs。

Program.cs

using System;
using System.Threading.Tasks;
using Microsoft.Graph.Communications.Common.Telemetry;
using Microsoft.Graph.Communications.Samples.Common;

namespace Microsoft.Graph.Communications.Samples.AudioVideoPlaybackBot
{
    public class Program
    {
        public static async Task Main(string[] args)
        {
            var logger = new Logger("AudioVideoPlaybackBot", redirectToConsole: true);
            var bot = new AudioVideoPlaybackBot(logger);
            await bot.RunAsync();
        }
    }
}

启动文件介绍

• Program.cs: 这是项目的入口文件，包含了程序的主函数 Main。
  • Logger: 用于日志记录的类，帮助调试和监控程序运行状态。
  • AudioVideoPlaybackBot: 这是主要的机器人类，负责处理音频和视频的播放逻辑。
  • RunAsync: 异步方法，启动机器人并开始处理通信请求。

3. 项目的配置文件介绍

在 Samples/V1.0Samples/LocalMediaSamples/AudioVideoPlaybackBot/ 目录下，主要的配置文件是 appsettings.json。

appsettings.json

{
  "Logging": {
    "LogLevel": {
      "Default": "Information",
      "Microsoft": "Warning",
      "Microsoft.Hosting.Lifetime": "Information"
    }
  },
  "AllowedHosts": "*",
  "AzureAd": {
    "Instance": "https://login.microsoftonline.com/",
    "Domain": "yourdomain.onmicrosoft.com",
    "TenantId": "your-tenant-id",
    "ClientId": "your-client-id",
    "ClientSecret": "your-client-secret"
  },
  "Bot": {
    "AppId": "your-bot-app-id",
    "AppSecret": "your-bot-app-secret"
  }
}

配置文件介绍

• Logging: 配置日志记录的级别，包括默认级别、Microsoft级别和Microsoft.Hosting.Lifetime级别。
• AllowedHosts: 允许访问的主机列表，通常设置为*表示允许所有主机。
• AzureAd: 配置Azure AD的身份验证信息，包括实例、域、租户ID、客户端ID和客户端密钥。
• Bot: 配置机器人的应用ID和应用密钥，用于身份验证和授权。

通过以上配置文件，项目可以正确地与Azure AD进行身份验证，并启动机器人服务。