实时文本（RTT）概述

实时文本 (RTT) 使开发人员能够在通话过程中准实时地传输文本。 此功能旨在帮助有语言障碍的个人，确保他们的文本消息能像语音交流一样，突出显示给其他参与者。 RTT 让参与者能够通过即时逐字符广播的输入消息进行有效沟通，而无需按“发送”键，从而增强辅助功能。

常见用例

构建无障碍体验

RTT 使有语言障碍的用户能够完全参与通话，有助于创建包容性的沟通平台。 通过提供实时运行的基于文本的通信通道，RTT 确保所有参与者都能平等地参与，无论他们说话的能力如何。

提升沟通清晰度

在因背景噪音或技术限制导致语音不清晰的情况下，RTT 作为可靠的替代方式，确保消息能够清晰传达。 此实时显示可确保在不误解的情况下传达关键信息。

何时使用实时文本 (RTT)

• 辅助功能要求：在开发需要符合辅助功能标准的应用程序时，启用 RTT 可确保有语言障碍的用户能够有效参与。
• High-Noise 环境： 在背景噪音影响音频质量的设置中，RTT 提供清晰可靠的通信方式。

RealTimeTextInfo/Details 类

RealTimeTextInfo（或某些平台上的 RealTimeTextDetails）类对于管理 RTT 消息至关重要。 它封装了有关每个 RTT 消息的所有必要信息，包括发送方、内容、序列标识符、结果类型、时间戳以及消息是否源自本地。

属性和字段

• Sender：提供有关发送 RTT 消息的用户的信息。
• SequenceId：维护消息顺序的唯一标识符。
• Text：RTT 消息的实际内容。
• ResultType/Kind：指示消息是部分消息 () 还是最终消息 (ResultType)，以确定是否可以编辑消息。Kind
• ReceivedTime：收到消息时的时间戳标记。
• UpdatedTime：指示消息的上次更新的时间戳。
• IsLocal： 一个布尔标志，指示本地用户是否发送了消息。

使用情况

开发人员可以通过单个事件订阅来订阅 RTT 事件，从而管理自己的 RTT 消息列表和排序。 这种方法与辅助字幕 API 保持一致，简化了集成和维护。 UI 负责将数据绑定到屏幕，管理显示列表，并根据消息的最终完成处理文本输入交互。

隐私问题

实时文本 (RTT) 仅在通话或会议期间可用。 Azure 通信服务不会在任何地方存储这些文本交换。 许多国家/地区都有适用于数据存储的法律和法规。 如果你选择存储通过 RTT 生成的任何数据，则你有责任在遵守法律的前提下使用 RTT。 必须以符合适用于每个参与者的法律的方式获得相关方的同意。

通过 Azure 通信服务与 Microsoft Teams 之间的互操作性，应用程序和用户可以参与 Teams 调用、会议和聊天。 在 Teams 呼叫或会议中启用 RTT 并存储时，你有责任确保应用程序用户收到通知。

Microsoft通过录制或 RTT 启动的 Azure 通信服务 API 向你指示，必须实时向应用程序用户界面中的用户传达这一事实。 你同意赔偿 Microsoft 因自己未能遵守此义务而产生的所有费用和损失。

后续步骤

• 快速入门 指南入门。
• 详细了解 隐藏式字幕。
• UI 库中的 RTT 入门。