开发第一个Meeting App

2023-10-19 12:32:16

今天我们来看一下如何使用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。

如果我们不需要默认的页面风格，我们还可以删除掉 _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();

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

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

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

ngrok http 5000

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

回到我们的代码，在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 中进行如下的配置。

完成后，我们就可以把这个 app 安装到一个 meeting中去。选择一个会议，点击安装后，就可以看到如下界面，这个就是我们的 Configure.cshtml 的页面所显示的内容。

点击 Save 按钮后，就可以在会议聊天界面和会议详情界面里看到多了一个tab，名字叫 MeetingAppDemo，这个名字也是在 Configure.cshtml 里指定的，而 tab 的内容是由 MainPage.cshtml 里的内容。

可以看到我们已经完成了我们第一个 teams meeting app，比较简陋，不过开发过程也足够简单。我们后面再来展开在这个 tab 里我们可以做什么事情。

码农公寓

相关文章