开发第一个Meeting App

今天我们来看一下如何使用c# net6 来开发一个 teams的 meeting app。首先先确保本地安装了最新版本的 net6。创建一个目录，然后在目录下输入下面的命令行，让 dotnet 来生成一个初步的asp.net core 代码框架。

dotnet new razor

代码框架生成如下的目录和文件，我们可以删除不需要的文件：Error.cshtml.cs, Error.cshtml, Index.cshtml, Index.cshtml.cs, Privacy.cshtml 和 Privacy.cshtml.cs。

first-meeting-app

如果我们不需要默认的页面风格，我们还可以删除掉 _ViewStart.cshtml。

然后，我们为了调试方便，我们调整一下端口。打开 Properties\launchSettings.json 文件，把 http 的端口都改成 5000, 把https的端口改成 5001。改完后的文件和如下的类似：

{"iisSettings": {"windowsAuthentication": false,"anonymousAuthentication": true,"iisExpress": {"applicationUrl": "http://localhost:5000","sslPort": 44350}},"profiles": {"FirstMeetingApp": {"commandName": "Project","dotnetRunMessages": true,"launchBrowser": true,"applicationUrl": "https://localhost:5001;http://localhost:5000","environmentVariables": {"ASPNETCORE_ENVIRONMENT": "Development"}},...

接下来我们打开 Program.cs 文件，删除如下这行，这样就不会强制跳转到 https 了。

app.UseHttpsRedirection();

这些准备工作完成后，我们就可以尝试运行一下，如下：

first-meeting-app

可以看到，我们的程序已经在监听 5000 和 5001 端口了。

然后我们使用下面这个命令来启动 ngork，让端口 5000 可以暴露到公网上，这样 Teams 就可以发送请求到我们的接口了。

ngrok http 5000

记下 ngrok 生成的一个临时的公网 url。后面会用到。

first-meeting-app

回到我们的代码，在Pages目录下增加两个文件，一个是Configure.cshtml文件，这个页面是用来配置的。内容如下：

@page "/configure"<!DOCTYPE html>
<html lang="en">
<head><meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1"><title>Demo</title>
</head>
<body>My first Meeting App <br><script src="https://statics.teams.cdn.office.net/sdk/v1.10.0/js/MicrosoftTeams.min.js" crossorigin="anonymous"></script><script>const mainPageUrl = 'https://e9a8-49-189-236-3.ngrok.io/MainPage';microsoftTeams.initialize();microsoftTeams.appInitialization.notifySuccess();microsoftTeams.settings.registerOnSaveHandler(function (saveEvent) {microsoftTeams.settings.setSettings({entityID: "MeetingApp Demo",contentUrl: mainPageUrl,suggestedTabName: "MeetingApp Demo",websiteUrl: mainPageUrl,});saveEvent.notifySuccess();});microsoftTeams.settings.setValidityState(true);</script>
</body>
</html>

上面代码里有两个关键部分，第一个是 mainPageUrl，里面就使用到了前面保存下来的ngrok的url，第二个关键是调用 Teams SDK的顺序，显示初始化 .initialize()，然后是.registerOnSaveHandler(，最后是告诉 teams，配置页面好了，.settings.setValidityState(true)。

第二个页面是 MainPage.cshtml，也放在 Pages 目录下：

@page "/MainPage"<!DOCTYPE html>
<html lang="en">
<head><meta charset="UTF-8"><meta http-equiv="X-UA-Compatible" content="IE=edge"><meta name="viewport" content="width=device-width, initial-scale=1.0"><title>Demo</title><link rel="stylesheet" href="/static/styles.css"><script src="https://statics.teams.cdn.office.net/sdk/v1.10.0/js/MicrosoftTeams.min.js"integrity="sha384-6oUzHUqESdbT3hNPDDZUa/OunUj5SoxuMXNek1Dwe6AmChzqc6EJhjVrJ93DY/Bv"crossorigin="anonymous"></script>
</head>
<body><h1>MainPage</h1>
</body>
</html>

这个页面比较简单，只是做个sample，后面我们再会展开讲这个。

代码完成后，我们就可以打开 Teams 的 App Studio，新增一个app，然后在 Tab 中进行如下的配置。

first-meeting-app