Playlog

播放只有联系人才能听到的 WAV 文件。您可以选择开始点和播放时间。 与 Play 或 Music 操作相比，Playlog 使您能够更好地控制播放的文件。例如，您可以： 播放自定义音乐或其他 WAV 文件，如录制的双方对话或语音消息。 选择 WAV 文件中的开始位置以及要播放的文件大小。 允许联系人通过 DTMF 当用户在电话按键上按下或敲击某个键时产生的信号音。 铃声中断文件播放。

依赖关系

• 只有联系人才能听到此操作播放的 WAV 文件。

• Playlog 无法播放 CXone 平台上的默认音乐文件。要播放默认音乐，您必须使用 Music 操作。

• 文件的最长持续时间为 30 分钟或更短。

• 此操作不支持 TTS 允许用户将录制的提示作为文本输入，并使用计算机生成的语音来朗读内容。。如果您需要 TTS 支持，请使用 PLAY、WHISPER 或 REQAGENT。

• 除非已触发 OnHold 事件，否则 Playlog 在 OnAnswer 之后不起作用。
• 仅当使用 ACD 录音时，播放记录的呼叫录音才奏效。

• 音频文件必须是具有以下属性的未压缩 WAV 文件：

  • 比特率：64 kbps
  • 音频样本大小：8 位
  • 渠道数：1（单渠道）
  • 音频采样频率：8 kHz
  • 音频格式：CCITT μ-Law

支持的脚本类型

电话

类似操作比较

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

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

输入属性

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

属性	说明
ContactIDorFile	输入要播放操作的 WAV 文件的文件名。您可以使用此属性中的变量。 如果要播放呼叫录音，可以输入记录呼叫的联系人 ID 分配给每个联系人的唯一数字标识符。在当前呼叫中，可通过 {contactId} 来引用它。仅当使用 ACD 录音录制呼叫时，此功能才有效。
StartOffset	可使您让选定的音频文件从您指定的点开始播放，而不是从开头开始。输入您希望操作从文件开头开始播放音频的秒数。变量替换通常用于此属性。 例如，您有一个一分钟长的音频文件，您希望每 30 秒使其中断一次以播放一条消息。使用三个 PLAYLOG 操作的循环。通过 StartOffset = 0 和 SecondsToPlay = 30，配置第一个 PLAYLOG 以播放您的保留音乐文件。使用您的消息音频文件配置第二个 PLAYLOG。通过 StartOffset = 0，配置第三个 PLAYLOG 以播放您的保留音乐文件。 此属性的默认值为 0，它会使文件每次都从开头播放。没有最大值，但如果您输入的值大于音乐文件的长度，则该操作会从开头播放文件。
SecondstoPlay	允许您播放所选音频文件的一部分。输入您要播放的文件的秒数。 默认值为 0，表示音乐文件从头到尾播放。发生这种情况时，OnComplete 分支条件满足且脚本采用该路径。 没有最大值，但如果您输入的数字大于文件长度，脚本将采用 OnComplete 分支路径。 当 SecondsToPlay 设置为大于零且小于文件总长度的任何值，则 Default 分支条件满足。 变量替换通常用于此属性。
StoponDTMF	指定您是否希望此操作在呼叫者按下电话上的号码时暂停录制。启用了此属性并且此操作检测到来自呼叫者电话的 DTMF 当用户在电话按键上按下或敲击某个键时产生的信号音。 时，录制会暂停，并且此操作将采用 Digit Pressed 分支条件。Set this property to True to enable or to False to disable.
CurrentPosition	输入用于接收录音中最后位置的变量名称。录音中的位置以秒为单位测量。当达到 SecondstoPlay 或呼叫者按下某个数字而暂停录音时，当前位置将保存在此变量中。执行的分支取决于文件播放暂停的原因。您可以使用该值在其停止的地方继续回放。
ClearDigits	当联系人按下电话上的按键时，会生成 DTMF 铃声并将其存储在缓冲区中。ClearDigits 允许您决定该操作如何处理操作开始时缓冲区中的 DTMF 当用户在电话按键上按下或敲击某个键时产生的信号音。 铃声。 启用后，此选项会在该操作开始时清除缓冲区。脚本中之前按下的任何键都不会传递到此操作中。如果您禁用此选项，则该操作将对通过缓冲区传递到该操作的任何 DTMF 铃声进行处理和操作。设置为 True 可启用，或者设置为 False 可禁用。当 DTMF 铃声传入此操作时，脚本会立即执行 OnDigit 分支条件的路径。 Set to True to enable this option or False to disable it.

结果分支条件

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

条件	说明
Default	除了脚本满足条件要求其接受其他分支的情况之外，所要采用的路径。如果未定义操作的其他分支，也会执行此操作。
OnComplete	录音播放到完成时所采取的路径。
OnPaused	录制达到 SecondstoPlay 所要采用的路径。
OnDigitPressed	当 DTMF 检测设置为 True 且联系人在操作过程中按下一个键时所采用的路径。

提示和技巧

• 使用 Playlog，您可以索引文件，播放您自己的自定义音乐文件，并播放您自己的自定义音频提示。
• Playlog 可用于重新播放使用 Logcontact 录制的双方对话，或重新播放录制的语音消息。
• Playlog 允许通过指定联系人 ID 分配给每个联系人的唯一数字标识符 轻松访问已录制的对话。也可让您对语音邮件的回放流程进行高级控制。例如，您可以将其与 CXone Attendant 脚本结合使用。