Add Comments to Canvas LMS via LTI 1.3
FastComments 通过 LTI 1.3 标准与 Canvas LMS 集成。 这会将实时评论和协作聊天直接添加到你的 Canvas 课程中 —— 无需在你的服务器上安装插件。
评论会自动显示在作业下方，教师可以通过 Rich Content Editor 在 Pages、Quizzes 和 Announcements 中嵌入 FastComments。SSO 通过 LTI launch 自动处理——学生使用他们的 Canvas 帐户发表评论，无需单独登录。该集成支持线程式评论、带文本高亮的实时协作聊天以及自动角色映射。
定价 
FastComments 的 LTI 1.3 集成包含在 Flex 和 Pro 计划中，无需额外费用。
快速开始
- 转到 您的 FastComments LTI 配置。
- 输入一个 配置名称 和您的 平台 URL（例如
https://yourschool.instructure.com）。选择要启用的 放置位置（作业查看和/或编辑器按钮 — 两者默认均已开启）。点击 创建配置。向导将进入第 2 步并显示您的 配置 URL。 - 在 Canvas 中，转到 Admin > Developer Keys > + Developer Key > LTI Key。将 Method 设置为 “输入 URL”，并粘贴配置 URL。保存密钥，然后将其 State 设置为 ON，并在提示时点击 允许。
- 从 Canvas 的 Developer Keys 表中复制 Client ID 号码。在 FastComments 中，将其粘贴到 Client ID 字段并点击 保存并继续。
- 查看配置摘要并点击 启用集成 以使其上线。
- 在 Canvas 中安装该外部应用（Admin > Settings > Apps > + App > By Client ID）。评论将自动出现在作业下方，教师可以通过富文本编辑器工具栏按钮将 FastComments 嵌入页面、测验和公告中。
FastComments 仪表板设置
导航到 LTI 配置
设置页面使用一个向导，逐步引导您完成每一步。您将从 第 1 步：创建 开始。
创建一个新的 LTI 配置
填写以下字段：
- 配置名称 - 一个可选标签，用于标识此配置（如果您连接多个 Canvas 实例，会很有用）。
- 平台 URL - 您的 Canvas 实例 URL（例如
https://yourschool.instructure.com）。此字段为必填。
选择放置位置
在平台 URL 下方，您可以选择 FastComments 在 Canvas 课程中显示的位置。默认启用两种放置方式：
- 作业视图 - 评论会自动显示在作业下方。
- 富内容编辑器按钮 - 教师可以使用富内容编辑器工具栏按钮在页面、测验和公告中嵌入 FastComments。
您可以启用其中一个或两个。必须至少启用一个放置位置。
点击 创建配置。
复制配置 URL
创建配置后，向导会进入 第 2 步：连接。页面顶部会以显著方式显示 配置 URL，并带有一个 复制 按钮。
复制此 URL。您将在下一步中需要它以在 Canvas 中创建开发者密钥。
页面还显示了在 Canvas 中需要执行操作的编号说明，以及在获取后用于输入 Client ID 和可选 Deployment ID 的字段。
Canvas 开发者密钥
在 Canvas 中打开 开发者密钥
以管理员身份登录 Canvas。转到左侧边栏的 管理（Admin）> 选择你的账户 > 开发者密钥（Developer Keys）。
创建 LTI 开发者密钥
点击 + 开发者密钥 并选择 LTI 密钥。
在配置表单中：
- 在 重定向 URI（左侧）字段中，粘贴来自 FastComments 设置页面的 启动 URL。
- 在右侧，将 方法 设置为 输入 URL。
- 将你从 FastComments 复制的 配置 URL 粘贴到 JSON URL 字段中。
- Canvas 会自动加载 LTI 配置。
- 为密钥命名（例如 “FastComments”）。
- 点击 保存。
启用 开发者密钥
保存后，新密钥会出现在开发者密钥表中，其 状态 显示为 关闭（OFF）。点击切换按钮将其设置为 开启（ON）。Canvas 可能会提示你确认 — 点击 允许（Allow）以启用该密钥。
复制 客户端 ID
开发者密钥表在详情列中显示一个数字 客户端 ID（例如 17000000000042）。复制此编号——下一步你将需要它。
完成连接
在 FastComments 中输入 Client ID
回到 您的 FastComments LTI Config。向导应处于 Step 2: Connect。
将您从 Canvas 复制的 Client ID 粘贴到 Client ID 字段。若您的 LMS 提供 Deployment ID，可选择性地输入。
点击 Save & Continue。
启用集成
向导会进入 Step 3: Go Live。会显示您的配置摘要（名称、平台 URL、Client ID 和 deployment ID）。
查看详细信息，然后点击 Enable Integration 以激活 LTI 连接。
启用后，向导会显示 Management View，在此您可以编辑配置、查看所有 LTI URL，或添加额外的部署。
在 Canvas 中安装外部应用
在 Canvas 中，进入 Admin > 选择您的账户 > Settings > Apps 选项卡。
点击 + App 并进行以下配置：
- 将 Configuration Type 设置为 By Client ID。
- 将 Developer Keys 表中的 Client ID 粘贴进去。
- 点击 Submit。
- 在提示时确认安装。
FastComments 现在已在账户级别安装，可用于所有课程。
添加到课程
评论在您的课程中的显示方式
一旦启用 LTI 集成并安装了外部应用，FastComments 会根据您配置的放置位置自动工作：
作业视图
如果启用了 Assignment View 放置，课程中每个作业下方会自动显示评论。学生和教师在查看作业时会看到一个线程式评论区 — 每个作业无需额外设置即可使用。
每个作业都有各自独立的评论线程。
富文本编辑器按钮
如果启用了 Editor Button 放置，教师可以将 FastComments 嵌入到任何使用富文本编辑器的内容中：
- 编辑 页面、测验 或 公告。
- 在富文本编辑器工具栏中，点击 FastComments 按钮。
- FastComments 会自动嵌入到内容中。
- 保存页面。
当学生查看该页面时，嵌入的 FastComments 小部件会加载，并显示该页面独有的评论线程。
自动单点登录 (SSO)
在这两种放置方式中，学生会通过他们的 Canvas 账户自动登录。姓名、电子邮件和头像会通过 LTI 启动进行同步 — 无需单独登录。
评论样式
FastComments 将线程式评论添加到您的 Canvas 课程。标准 FastComments 小部件显示在页面上。用户可以发布线程式评论、回复、投票，并使用所有标准功能。
评论附加到每个课程页面或资源链接，因此讨论会按页面、作业或模块进行组织。
角色映射
Canvas 角色会在 LTI 启动期间自动映射到 FastComments 角色。无需手动配置。
角色映射
| Canvas Role | FastComments Role | Permissions |
|---|---|---|
| Administrator | Admin | 完整的帐户访问权限，管理所有评论和设置 |
| Instructor | Moderator | 编辑和删除评论、置顶主题、管理讨论 |
| Learner | Commenter | 发布评论、回复、投票并使用提及功能 |
工作原理
当用户从 Canvas 启动 FastComments 时，LTI 1.3 协议会包含他们的 Canvas 角色。FastComments 读取该角色并自动分配相应的权限。
如果用户具有多个角色（例如同时是 Instructor 和 Admin 的用户），将使用权限最高的角色。
自定义
域名错误
您可能会遇到授权错误，如下所示：
这是因为 FastComments 不知道应该允许在此域上使用您的帐户。
在这种情况下，解决方法很简单。您只需将您的 Canvas 实例域名添加到您的 FastComments 帐户中。
添加您的 Canvas 域名（例如 yourschool.instructure.com），评论应能正常加载。