Music

このヘルプページはCXone Studio用です。この情報は、Desktop Studio用にも提供されています。

Musicアクションによって連絡先の音楽ファイルが再生されます。

連絡先の音楽ファイルが再生されます。Musicは、通常、コンタクトがキューやホールディングのシナリオにあるときの保留音に使用されます。デフォルトの音楽ファイルリストから選択できます。このアクションは、いかなる種類のカスタム音声ファイルにも対応していません。ファイルの再生時間や、何秒後に音楽が始まるかなどを選択することができます。

Musicアクションで利用できる録音済み音楽ファイルは、プロのミュージシャンが作成したライセンス楽曲です。これらは定期的に再ライセンスを受ける必要があります。場合によっては、ファイルのライセンスが更新できないことがあります。そんな時、NICE CXoneは似たようなジャンルの代替曲を用意しています。置き換え用の音楽は、既存のIVR 発信者が音声コマンド、キー入力、またはその両方を介して対話し、情報を取得したり、着信音声通話をルーティングしたり、あるいはその両方を行うことができる自動電話メニュー。でシームレスに動作します。NICE CXoneは、音楽ファイルの変更を事前に通知するため、交換内容を確認し、選択内容を変更することができます。

依存関係

onAnsweronHoldイベントの一部でない限り、イベント後は動作しません.
Musicアクションをそれ自体につなげてループを作ることは絶対にしないでください。音楽をリピートさせたい場合は、0.5秒など短いポーズで構成されたWaitアクションを使用します。MusicをWaitに接続し、さらにMusicに戻す。
Musicで使用できるデフォルトのファイルの長さは最大5分です。

サポートされているスクリプトタイプ

電話

類似アクションの比較

以下のアクションには同様の機能がありますが、いくつかの重要な相違点があります。

Music：コンタクトだけに聞こえる音楽ファイルを再生します。用意された音楽ファイルのリストから選択できます。ファイル内で特定の開始点と停止点を指定できます。カスタム音声ファイルの再生には対応していません。
Play：カスタムオーディオ（WAV）ファイルやテキスト読み上げ（TTS ユーザーが録音されたプロンプトをテキストとして入力し、コンピューターで生成された音声を使用してコンテンツを話すことができるようにします。）プロンプトを再生します。ファイル全体が再生されます。音声はコンタクトにしか聞こえません。
Playlog：コンタクトだけに聞こえるカスタムオーディオ（WAV）ファイルを再生します。特定の開始点と停止点を選択できます。Musicなど他のアクションに格納されている音楽ファイルは再生できません。
Reqagent：エージェントだけに聞こえるカスタムオーディオ（WAV）ファイルやテキスト読み上げプロンプトを再生します。エージェントとコンタクトがリンクする前にプロンプトが再生されるため、プロンプトによってコンタクトが沈黙になることはありません。
Whisper：カスタムのWAVファイルやテキスト読み上げプロンプトを再生します。コンタクトのみ、エージェントのみ、または両方に聞こえるように設定できます。プロンプトはエージェントとコンタクトがリンクした後に再生されるため、エージェントまたはコンタクトのみにアクションが再生された場合、相手にはプロンプトの間、沈黙が聞こえます。
Ziptone：コンタクトとエージェントがリンクされた後、エージェントに発信音を再生します。ReqagentアクションにはZiptoneプロパティがあり、これはコンタクトとエージェントがリンクされる前にエージェント用の発信音を再生します。

入力プロパティ

これらのプロパティは、アクションが実行時に使用するデータを定義します。

このアクションのすべてのプロパティは、変数置換を受け入れます。

プロパティ	説明
キャプションを追加	スクリプト内でこのアクションを一意に識別できる、短いフレーズを入力します。アクションアイコンにカーソルを合わせるとキャプションが表示されます。
Music File	アクションによって再生される、事前に録音された音楽ファイルを選択できます。Studioには20種類の音楽ファイルがWAVフォーマットで含まれており、そこから選択できます。アップロードした音楽ファイルを再生したい場合は、代わりにPlaylogアクションを使用して行うことができます。このプロパティには変数を使用できます。
Start Offset	選択したオーディオファイルの再生を、最初からではなく、指定した位置から開始させることができます。音声の再生を開始させたいファイルの先頭から何秒かを入力します。このプロパティでは変数置換を一般的に使用できます。たとえば、2つのMusicアクションと1つのWaitアクションのループがある場合、最初のMusicアクションでファイルの先頭から再生することができます。最初のMusicアクションを30秒再生し、最初のアクションが停止した箇所から2番目のMusicアクションで再生を再開するには、StartOffsetを30に設定します。このプロパティのデフォルト値は0なので、毎回ファイルは最初から再生されます。最大値はありませんが、音楽ファイルの長さを超える値を入力すると、アクションはファイルを最初から再生します。
Seconds To Play	選択した音声ファイルの一部を再生することができます。再生したいファイルの秒数を入力します。デフォルト値は 0で、ファイルの先頭から末尾まで再生することを意味します。この場合、OnCompleteの分岐条件が満たされ、スクリプトはそのパスを取ります。最大値はありませんが、ファイルの長さを超える数値を入力すると、スクリプトはOnCompleteの分岐パスを取ります。 Default分岐条件は、 SecondsToPlayに、0より大きくかつファイルの全長より小さい値が設定された場合に満たされます。このプロパティでは変数置換を一般的に使用できます。
Interrupt Messages	.wavファイルの形式で1つ以上のショートメッセージで音楽を定期的に中断する文字列式を入力できます。次の例に示すように、式では次の構文を使用する必要があります。メッセージファイルの名前;SecondsToPlay。 Message1.wav; 45 Message2.wav; 60 Message3.wav; 60 この方法は機能しますが、問題が発生する可能性があります。たとえば、メッセージが後で再録音され、元のメッセージよりも長い場合、前のメッセージが終了する前に1つのメッセージが再生を開始する可能性があります。したがって、定期的なメッセージによって中断された音楽を再生するための推奨される方法は、適切なメッセージまたはプロンプトを提供するMusicアクションでPlayまたはPlaylogアクションを代替することです。
Repeat Index	このプロパティには、 InterruptMessagesを繰り返したい回数を設定します。割り込みメッセージを設定しなかった場合は、このプロパティを省略することができます。
DetectDTMF	アクションの実行中にDTMF ユーザーが電話のキーパッドのキーを押すかタップしたときに生成される信号音。トーンを処理するかどうかを決定します。有効にすると、アクションはDTMFトーンを処理し、それに対して動作します。アクションでは発信音をキャプチャできません。無効にすると、コンタクトが電話のキーを押しても、アクションはDTMFトーンを無視します。たとえば、コンタクトが保留にされている間、メッセージの中断を再生し、「エージェントがすぐ応対させていただきます。折り返しお電話するためにボイスメールを残される場合は、スターキーを押してください」と言います。DetectDTMFをオンに設定し、アクションがコンタクトのキー押下を処理できるようにする必要があります。値モード：このオプションを無効にするには、クリックしてNoに設定します。クリックしてオンにすると、DTMFトーンを検出して応答するアクションが有効になります。式モードこのオプションを無効にするにはfalseを入力します。trueのままにすると、DTMFトーンを検出して応答するアクションが有効になります。このプロパティが有効で、コンタクトがキーを押すと、 Digit分岐がトリガーされます。このプロパティで変数代入を使用できます。そのためには、このプロパティを式モードに設定してから、フィールドに変数を入力します。変数は中括弧({})で囲みます。
Clear Digits	コンタクトが電話のキーを押すと、DTMF発信音が生成され、バッファに保存されます。ClearDigitsを使うと、このアクションの開始時にバッファにあるDTMF ユーザーが電話のキーパッドのキーを押すかタップしたときに生成される信号音。発信音の処理方法を決定することができます。有効にすると、このオプションはアクション開始時にバッファをクリアします。スクリプトの前の方で起こったキー操作は、このアクションに渡されません。このオプションを無効にすると、アクションは、バッファを通してアクションに渡されたすべてのDTMFトーンを処理し、それに対して動作します。Trueに設定すると有効になり、Falseに設定すると無効になります。このアクションにDTMF発信音が渡されると、スクリプトは直ちにDigit分岐条件のパスを取ります。値モード：このオプションを無効にするには、クリックしてNoに設定します。Yesのままにすると、DTMFバッファがクリアされます。式モードこのオプションを無効にするにはfalseを入力します。trueのままにすると、DTMFバッファがクリアされます。

結果ブランチ条件

結果の分岐条件を使用すると、アクションが実行されたときにさまざまな結果を処理できるように、スクリプトにブランチを作成できます。

条件	説明
Default	スクリプトが他の分岐の1つをとる必要がある条件を満たさない限り、取られるパス。他のブランチが定義されていない場合にも使用されます。 Musicの場合は、ブランチは、SecondsToPlayが0より大きくかつ選択されたMusicFileの全長より小さい値が設定された場合に満たされます。
Complete	録音が最後まで再生されるときに取られるパス。
Paused	この分岐条件は現在使用されていません。
Digit	DetectDTMFがTrueに設定されており、アクション中にコンタクトが電話のキーを押した場合に取られるパス。

スクリプトの例

これは、このアクションをスクリプトでどのように使用できるかを示す例です。完全なスクリプトではありません。追加のスクリプト作成が必要な場合があります。

この部分的なスクリプトの例では、エージェントが電話に出るのをコンタクトが待つ間に音楽が再生されます。SecondstoPlayプロパティで設定された期間音楽が再生された後、Waitアクションは音楽が再開する前に一時停止を導入します。Musicアクションは、Captionプロパティを使用して名前が変更され、MusicFileプロパティで指定された.wavファイル（CruisingJazz.wav）を示します。

前述のように、Waitアクションの代わりにPlaylogアクションを使用することもできます。

この例をダウンロードしますか？