通过

你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

在 Direct Line API 3.0 中重新连接到对话

  • 项目

如果客户端使用 WebSocket 接口来接收消息但丢失了连接，则可能需要重新连接。 在这种情况下，客户端必须生成一个新的 WebSocket 流 URL，它可以用来重新连接到聊天。

生成新的 WebSocket 流 URL

若要生成可用于重新连接到现有聊天的新 WebSocket 流 URL，请发出此请求：

GET https://directline.botframework.com/v3/directline/conversations/{conversationId}?watermark={watermark_value}
Authorization: Bearer SECRET_OR_TOKEN

在此请求 URI 中，请将 {conversationId} 替换为聊天 ID，并将 {watermark_value} 替换为水印值（如果 watermark 参数 可用）。 watermark 参数是可选的。 如果在请求 URI 中指定了 watermark 参数，则聊天会从水印处重播，从而保证不会丢失任何消息。 如果请求 URI 中省略了 watermark 参数，则仅重播重新连接请求后收到的消息。

以下代码片段提供了重新连接请求和响应的示例。

请求

GET https://directline.botframework.com/v3/directline/conversations/abc123?watermark=0000a-42
Authorization: Bearer RCurR_XV9ZA.cwA.BKA.iaJrC8xpy8qbOF5xnR2vtCX7CZj0LdjAPGfiCpg4Fv0y8qbOF5xPGfiCpg4Fv0y8qqbOF5x8qbOF5xn

响应

如果请求成功，则响应将包含聊天 ID、令牌和新的 WebSocket 流 URL。

HTTP/1.1 200 OK
[other headers]

{
  "conversationId": "abc123",
  "token": "RCurR_XV9ZA.cwA.BKA.iaJrC8xpy8qbOF5xnR2vtCX7CZj0LdjAPGfiCpg4Fv0y8qbOF5xPGfiCpg4Fv0y8qqbOF5x8qbOF5xn",
  "streamUrl": "https://directline.botframework.com/v3/directline/conversations/abc123/stream?watermark=000a-4&t=RCurR_XV9ZA.cwA..."
}

重新连接到聊天

客户端必须使用新的 WebSocket 流 URL 在 60 秒内重新连接到聊天。 如果在此期间无法建立连接，客户端必须发出另一个重新连接请求来生成新的流 URL。

如果 Direct Line 设置中启用了“增强身份验证选项”，则在未将正确配置的令牌附加到请求的情况下，可能会收到 400“MissingProperty”错误。

其他资源