Play

This help page is for Desktop Studio.This information is also available for CXone Studio.

作为交互的一部分，播放一个或多个音频文件。

Play 可以使用预先录制的音频文件、文本到语音转换 (TTS 允许用户将录制的提示作为文本输入，并使用计算机生成的语音来朗读内容。) 或两者的组合。坐席无法听到通过此操作播放的内容。它仅为联系人播放音频。如果您希望坐席和联系人都能够听到音频，请使用 Whisper操作。

此操作的一个常见用例是为呼叫者播放消息。例如，“感谢您致电 Classics 公司”或“为了保证服务质量，您的通话可能会被录音”。

您也可以使用 Play 操作通过将变量合并到操作序列中，将信息传递给呼叫者。例如，通过从 CRM 管理联系人、销售信息、支持详细信息和案例历史记录等事项的第三方系统。或订单管理系统引入数据，您可以使用 Play 操作来构建订单更新消息，如“您最近订购的 {numberOfItems} 商品，总额为 {orderTotal}，已于 {shipDate] 发货”。

依赖关系

除非已触发 onHold 事件，否则 Play 在 onAnswer 之后不起作用。
您无法选择开始位置或播放时间。Play 每次都从头开始播放音频文件。它还会播放整个文件或序列，除非已启用 DetectDTMF 并且联系人输入了 DTMF 当用户在电话按键上按下或敲击某个键时产生的信号音。铃声。
序列属性中的每个序列的字符数限制为 300 个。如果您需要播放的文本长度超过此长度，您可以在属性字段中添加其他序列数量。例如，“%这是序列一。”“%这是序列二。”
对于 TTS 提示，如果要指定 TTS 服务使用的语音和语言，则需要执行 Voiceparams action。
音频文件必须是具有以下属性的未压缩 WAV 文件：
- 比特率：64 kbps
- 音频样本大小：8 位
- 渠道数：1（单渠道）
- 音频采样频率：8 kHz
- 音频格式：CCITT μ-Law

支持的脚本类型

The icon for the Phone script type - an old-style phone handset with curved lines indicating sound coming out of it.

电话

类似操作比较

以下操作具有类似功能，但存在一些关键区别：

Music：播放只有联系人才能听到的音乐文件。您可以从提供的音乐文件列表中进行选择。您可以在文件中指定特定的开始点和停止点。不支持播放自定义音频文件。
Play：播放自定义音频 WAV 文件或文本转语音 (TTS 允许用户将录制的提示作为文本输入，并使用计算机生成的语音来朗读内容。) 提示。播放整个文件。只有联系人才能听到该音频。
Playlog：播放只有联系人才能听到的自定义 WAV 文件。它允许您选择特定的开始点和停止点。无法播放内置于其他操作的音乐文件，例如 Music。
Reqagent：播放只有坐席能听到的自定义音频 WAV 文件或文本转语音提示。提示会在坐席和联系人链接之前播放，因此提示不会导致联系人听到静音。
Whisper：播放自定义 WAV 文件或文本转语音提示。您可以将其设置为仅联系人、仅坐席或两者均可听到。提示会在坐席和联系人链接之后播放，因此如果该操作仅针对坐席或联系人播放，则另一方在提示期间将听到静音。
Ziptone：在联系人和坐席链接之后为坐席播放提示音。Reqagent 操作有一个 Ziptone 属性，在链接联系人和坐席之前为坐席播放提示音。

输入属性

这些属性定义操作在执行时使用的数据。

属性	说明
Caption	输入在脚本中唯一标识此操作的短语。标题显示在脚本画布上的操作图标下方。The default is the action name.
Sequence	定义操作播放的提示符。如果提示为音频文件，请输入用双引号括起来的文件名。例如，"greeting.wav"。如果提示为文本到语音转换，请单击省略号按钮并输入您希望 TTS 允许用户将录制的提示作为文本输入，并使用计算机生成的语音来朗读内容。服务读取的文本。每个片段必须用双引号括起来，并包含一个字符串引用字符，以标识其信息类型。例如： "%Your account balance is" "silence.wav" "${accountBalance}" 有关此属性中设置提示格式的详细信息，请参阅Manage Prompts页面。您也可以双击操作图标以使用序列编辑器创建提示。在 Sequence 属性中，TTS 提示的长度限制为 300 个字符。您可以单击操作属性中的打开编辑器，使用序列编辑器创建提示。 For more information about formatting prompts in this property, see the Prompts page.You can also double-click the action on the canvas to open the Sequence Editor to create your prompt. 序列属性中的每个序列的字符数限制为 300 个。如果您需要播放的文本长度超过此长度，您可以在属性字段中添加其他序列数量。例如，“%这是序列一。”“%这是序列二。”
Phrase	使用此属性来记录提示包含的文本。该脚本不使用此属性中的文本。因为有些提示可能很复杂，并且包含多个片段，所以包含没有按照序列要求的格式编写的文本可能会很有帮助。
ClearDigits	当联系人按下电话上的按键时，会生成 DTMF 铃声并将其存储在缓冲区中。ClearDigits 允许您决定该操作如何处理操作开始时缓冲区中的 DTMF 当用户在电话按键上按下或敲击某个键时产生的信号音。铃声。启用后，此选项会在该操作开始时清除缓冲区。脚本中之前按下的任何键都不会传递到此操作中。如果您禁用此选项，则该操作将对通过缓冲区传递到该操作的任何 DTMF 铃声进行处理和操作。设置为 True 可启用，或者设置为 False 可禁用。当 DTMF 铃声传入此操作时，脚本会立即执行 OnDigit 分支条件的路径。 Set to True to enable this option or False to disable it.
DetectDTMF	Determines whether DTMF 当用户在电话按键上按下或敲击某个键时产生的信号音。 tones are processed while the action is running.The default value is True, which means that DTMF tones are processed if the contact presses a key and the OnDigit branch of the script is triggered.If the value is set to False, DTMF tones are not processed even if the contact presses a key.For example, you might play a message at the point a contact is placed in queue which says, "An agent will be with you shortly.To leave the queue at any time, press the star key".The OnDigit branch might then offer the contact the option to leave a voicemail message. This property does not capture DTMF tones.If you need to evaluate an entered tone, use a Captureaction after this action to assign the tone to a variable.You can then evaluate the variable's value to determine which tone was entered. 变量替换通常用于此属性。

结果分支条件

结果分支条件允许您在脚本中创建分支，以在执行操作时处理不同的结果。

条件	说明
Default	除了脚本满足条件要求其接受其他分支的情况之外，所要采用的路径。如果没有定义其他分支，也会使用该路径。
OnDigit	将 DetectDTMF 设为 True 且联系人在操作过程中按下某个键时所执行的路径。

提示和技巧

联络中心坐席无法听到 Play 操作的音频。如果您希望将音频同时播放给呼叫者和坐席，请使用 Whisper action。
使用短语字段添加提示文本的注释或摘要。

脚本示例

这是一个示例，说明如何在脚本中使用此操作。它并不是一个完整的脚本。可能还需要编写其他脚本。

Play 可以用在许多不同的方面。在本示例中，营业时间配置文件可确定公司是开放、关闭还是休假。如关闭，将会播放一条消息。如休息，将会播放另一条消息。如开放，将会请求一位坐席。

您想下载这个脚本吗？