- Programmable Voice
- Getting Started with Programmable Voice
- APIリファレンス
- TwiML
- チュートリアル
- Programmable Voice SDK for iOS and Android
- SIPドメイン
- Twilio クライアント
- 留守番電話検出
- トラブルシューティング

TwiML™ Voice： <Say>

<Say>動詞は、発信者に対して、テキストの文字列を読み上げることができます。<Say>動詞は、動的に生成したテキストや、事前に録音しておくのが難しい種類のテキストを読み上げる際に便利です。音声の読み上げる音声にはいくつか種類があり、それぞれでサポートしている言語、性別があります。ご希望の組み合わせを TwiML の中で指定してください。

動詞の属性

<Say>動詞では、'voice' パラメータで与えたものによって、それぞれ与えられる属性が異なります。

voice

<Say>動詞では、2種類の別々のボイスエンジンが選べます。まず man と woman、これらは共に英語、スペイン語、フランス語、ドイツ語、イタリア語で利用できます。次にalice、これはもう少し幅広い言語で利用できる女性の声です。

属性名	許容値	初期値
voice	man, woman, alice	man (一部の言語に対応); alice (一部の追加された言語に対応)
loop	0 以上の整数	1
language	後述のセクションを参照	後述のセクションを参照

voice = man または woman のとき

voice に man または woman を指定した際は、以下の属性と値を指定できます。
※ 以下の値が言語の属性として使用できます。

属性名	許容値	初期値
language	en、en-gb、es、fr、de	en

DIAL動詞と SMS動詞は、複数の属性を使えます。

下の例ではcallerIdパラメータが省略されていますが、Twilio for KDDI Web Communications をご利用のお客様においては、callerId パラメータで必ずご自身で購入したTwilio電話番号を指定する必要があり、かつ、省略できません。

DIAL動詞で電話をかける場合にはTwilio電話番号（050/0120/0800/その他番号）を、SMS動詞でSMSを送信する場合にはアメリカ番号もしくはSMSが有効なTwilio番号を指定する必要があります。

Say動詞内での属性の使用

SDKバージョン:

形式:

TwiML

const VoiceResponse = require('twilio').twiml.VoiceResponse;

const response = new VoiceResponse();
response.say(
  {
    voice: 'woman',
    language: 'fr',
  },
  'Chapeau!'
);

console.log(response.toString());

using Twilio.TwiML;
using System;


class Example
{
    static void Main()
    {
        var response = new VoiceResponse();
        response.Say("Chapeau!", voice: "woman", language: "fr");

        Console.WriteLine(response.ToString());;
    }
}

<?php
require_once './vendor/autoload.php';
use Twilio\Twiml;

$response = new Twiml();
$response->say('Chapeau!', ['voice' => 'woman', 'language' => 'fr']);

echo $response;

require 'twilio-ruby'

response = Twilio::TwiML::VoiceResponse.new
response.say('Chapeau!', voice: 'woman', language: 'fr')

puts response

from twilio.twiml.voice_response import VoiceResponse, Say

response = VoiceResponse()
response.say('Chapeau!', voice='woman', language='fr')

print(response)

import com.twilio.twiml.TwiMLException;
import com.twilio.twiml.voice.Say;
import com.twilio.twiml.voice.Say.Language;
import com.twilio.twiml.VoiceResponse;

public class Example {
    public static void main(String[] args) {
        Say say = new Say.Builder("Chapeau!").voice(Say.Voice.WOMAN)
            .language(Language.FR_FR).build();
        VoiceResponse response = new VoiceResponse.Builder().say(say).build();

        try {
            System.out.println(response.toXml());
        } catch (TwiMLException e) {
            e.printStackTrace();
        }
    }
}

<?xml version="1.0" encoding="UTF-8"?>
<Response>
    <Say voice="woman" language="fr-FR">Chapeau!</Say>
</Response>

Say動詞内での属性の使用

voice = alice の場合

voice に alice を指定した際は、下記の属性と値を設定できます。
以下の値が言語属性として使用できます。

属性名	許容値	言語、ロケール	初期値
language	da-DK de-DE en-AU en-CA en-GB en-IN en-US ca-ES es-ES es-MX fi-FI fr-CA fr-FR it-IT ja-JP ko-KR nb-NO nl-NL pl-PL pt-BR pt-PT ru-RU sv-SE zh-CN zh-HK zh-TW	デンマーク語, デンマークドイツ語, ドイツ英語, オーストラリア英語, カナダ英語, イギリス英語, インド英語, アメリカカタルーニャ語, スペインスペイン語, スペインスペイン語, メキシコフィンランド語, フィンランドフランス語, カナダフランス語, フランスイタリア語, イタリア日本語, 日本韓国語, 韓国ノルウェー語, ノルウェーオランダ語, オランダポーランド語, ポーランドポルトガル語, ブラジルポルトガル語, ポルトガルロシア語, ロシアスウェーデン語, スウェーデン中国語, 中国中国語, 香港中国語, 台湾	en-US

Say動詞内の属性として特定の言語を使用

SDKバージョン:

形式:

TwiML

const VoiceResponse = require('twilio').twiml.VoiceResponse;

const response = new VoiceResponse();
response.say(
  {
    voice: 'alice',
    language: 'fr-FR',
  },
  'Chapeau!'
);

console.log(response.toString());

using Twilio.TwiML;
using System;


class Example
{
    static void Main()
    {
        var response = new VoiceResponse();
        response.Say("Chapeau!", voice: "alice", language: "fr-FR");

        Console.WriteLine(response.ToString());;
    }
}

<?php
require_once './vendor/autoload.php';
use Twilio\Twiml;

$response = new Twiml();
$response->say('Chapeau!', ['voice' => 'alice', 'language' => 'fr-FR']);

echo $response;

require 'twilio-ruby'

response = Twilio::TwiML::VoiceResponse.new
response.say('Chapeau!', voice: 'alice', language: 'fr-FR')

puts response

from twilio.twiml.voice_response import VoiceResponse, Say

response = VoiceResponse()
response.say('Chapeau!', voice='alice', language='fr-FR')

print(response)

import com.twilio.twiml.TwiMLException;
import com.twilio.twiml.voice.Say;
import com.twilio.twiml.voice.Say.Language;
import com.twilio.twiml.VoiceResponse;

public class Example {
    public static void main(String[] args) {
        Say say = new Say.Builder("Chapeau!").voice(Say.Voice.ALICE)
            .language(Language.FR_FR).build();
        VoiceResponse response = new VoiceResponse.Builder().say(say).build();

        try {
            System.out.println(response.toXml());
        } catch (TwiMLException e) {
            e.printStackTrace();
        }
    }
}

<?xml version="1.0" encoding="UTF-8"?>
<Response>
    <Say voice="alice" language="fr-FR">Chapeau!</Say>
</Response>

Say動詞内の属性として特定の言語を使用

language

'language' 属性は、使用する言語を指定し、その言語における一般的なアクセントと発音が用いられます。Twilio では voice の指定によって、対応する言語が違います。man と woman で英語を使いたいとき、アメリカ英語のアクセントであれば en を、イギリス英語のアクセントであれば en-gb を選びます。また、スペイン語なら es、フランス語なら fr、イタリア語なら it、ドイツ語なら de を選びます。デフォルトは en です。

Alice は更に多くの言語に対応しています。voice を alice に指定すると、合計26方言(18言語 14ロケール) が選択できることになります。Alice で対応する言語の詳細は、上表を御覧ください。

ご注意: Alice のみに対応する言語指定を行い、voice 指定を行わなかった場合、デフォルトでは Alice が適用されます。例えば、以下の TwiML ではデフォルトで Alice が指定されます。

アリスの声が既定となるSay動詞

SDKバージョン:

形式:

TwiML

const VoiceResponse = require('twilio').twiml.VoiceResponse;

const response = new VoiceResponse();
response.say({
    language: 'sv-SE'
}, 'Hej!');

console.log(response.toString());

using Twilio.TwiML;
using System;


class Example
{
    static void Main()
    {
        var response = new VoiceResponse();
        response.Say("Hej!", language: "sv-SE");

        Console.WriteLine(response.ToString());;
    }
}

<?php
require_once './vendor/autoload.php';
use Twilio\Twiml;

$response = new Twiml();
$response->say('Hej!', ['language' => 'sv-SE']);

echo $response;

require 'twilio-ruby'

response = Twilio::TwiML::VoiceResponse.new
response.say('Hej!', language: 'sv-SE')

puts response

from twilio.twiml.voice_response import VoiceResponse, Say

response = VoiceResponse()
response.say('Hej!', language='sv-SE')

print(response)

import com.twilio.twiml.VoiceResponse;
import com.twilio.twiml.voice.Say;
import com.twilio.twiml.voice.Say.Language;
import com.twilio.twiml.TwiMLException;

public class Example {
    public static void main(String[] args) {
        Say say = new Say.Builder("Hej!").language(Language.SV_SE).build();
        VoiceResponse response = new VoiceResponse.Builder().say(say).build();

        try {
            System.out.println(response.toXml());
        } catch (TwiMLException e) {
            e.printStackTrace();
        }
    }
}

<?xml version="1.0" encoding="UTF-8"?>
<Response>
    <Say language="sv-SE">Hej!</Say>
</Response>

アリスの声が既定となるSay動詞

loop

loop 属性には、テキストの読み上げを繰り返す回数を指定します。初期値は 1 です。「0」を指定すると、通話が切れるまで <Say> 動詞を繰り返し実行します。

名詞

TwiMLの動詞にネストされた名詞は、それ自体は動詞ではありません。動詞がその上でどのように働くかを示します。これらは <Say>動詞の名詞です。

名詞	概要
plain text	発信者へ読み上げるテキスト文。最大 4,096 ユニコード文字まで受け付けます。

ネスティングルール

<Say> の中には、動詞をネストできません。ただし、次の動詞の中に <Say> をネストできます。

<Gather>

サンプル

例 1: Hello World

以下のTwiMLへ着信すると、1度だけ男性の声で "Hello world" と発話します。

Hello World

SDKバージョン:

形式:

TwiML

const VoiceResponse = require('twilio').twiml.VoiceResponse;

const response = new VoiceResponse();
response.say('Hello World');

console.log(response.toString());

using Twilio.TwiML;
using System;


class Example
{
    static void Main()
    {
        var response = new VoiceResponse();
        response.Say("Hello World");

        Console.WriteLine(response.ToString());;
    }
}

<?php
require_once './vendor/autoload.php';
use Twilio\Twiml;

$response = new Twiml();
$response->say('Hello World');

echo $response;

require 'twilio-ruby'

response = Twilio::TwiML::VoiceResponse.new
response.say('Hello World')

puts response

from twilio.twiml.voice_response import VoiceResponse, Say

response = VoiceResponse()
response.say('Hello World')

print(response)

import com.twilio.twiml.VoiceResponse;
import com.twilio.twiml.voice.Say;
import com.twilio.twiml.TwiMLException;


public class Example {
    public static void main(String[] args) {
        Say say = new Say.Builder("Hello World").build();
        VoiceResponse response = new VoiceResponse.Builder().say(say).build();

        try {
            System.out.println(response.toXml());
        } catch (TwiMLException e) {
            e.printStackTrace();
        }
    }
}

<?xml version="1.0" encoding="UTF-8"?>
<Response>
     <Say>Hello World</Say>
</Response>

Hello World

例 2: Hello, Hello

このTwiMLでは、ポルトガル語でいう「こんにちは」を2回、発話します。

Hello, ブラジルポルトガル語でのHello

SDKバージョン:

形式:

TwiML

const VoiceResponse = require('twilio').twiml.VoiceResponse;

const response = new VoiceResponse();
response.say(
  {
    voice: 'alice',
    language: 'pt-BR',
    loop: 2,
  },
  'Bom dia.'
);

console.log(response.toString());

using Twilio.TwiML;
using System;


class Example
{
    static void Main()
    {
        var response = new VoiceResponse();
        response.Say("Bom dia.", voice: "alice", language: "pt-BR", loop: 2);

        Console.WriteLine(response.ToString());;
    }
}

<?php
require_once './vendor/autoload.php';
use Twilio\Twiml;

$response = new Twiml();
$response->say('Bom dia.', ['voice' => 'alice', 'language' => 'pt-BR',
    'loop' => 2]);

echo $response;

require 'twilio-ruby'

response = Twilio::TwiML::VoiceResponse.new
response.say('Bom dia.', voice: 'alice', language: 'pt-BR', loop: 2)

puts response

from twilio.twiml.voice_response import VoiceResponse, Say

response = VoiceResponse()
response.say('Bom dia.', voice='alice', language='pt-BR', loop=2)

print(response)

import com.twilio.twiml.VoiceResponse;
import com.twilio.twiml.voice.Say;
import com.twilio.twiml.voice.Say.Language;
import com.twilio.twiml.TwiMLException;

public class Example {
    public static void main(String[] args) {
        Say say = new Say.Builder("Bom dia.").voice(Say.Voice.ALICE)
            .language(Language.PT_BR).loop(2).build();
        VoiceResponse response = new VoiceResponse.Builder().say(say).build();

        try {
            System.out.println(response.toXml());
        } catch (TwiMLException e) {
            e.printStackTrace();
        }
    }
}

<?xml version="1.0" encoding="UTF-8"?>
<Response>
     <Say voice="alice" language="pt-BR" loop="2">Bom dia.</Say>
</Response>

Hello, ブラジルポルトガル語でのHello

ヒントとテクニック

<Say>動詞で発話すテキストの指定は最大 4,096 ユニコード文字までです。
ただし、日本語の場合現在424文字までとなっております。<SAY>動詞を複数並べることによりこの制限を超えることができます。
テキストから音声への変換で、<Say> 動詞は番号、日付、時間、金額、その他の省略記号の発音を推測します。これらの読み上げを十分にテストしてください。
'12345'と入力した場合「一万二千三百四十五(いちまんにせんさんびゃくよんじゅうご)」と発話します。一方 '1 2 3 4 5'と入力した場合「いち　に　さん　よん　ご」と発話します。
カンマやピリオドなどの句読点は、スピーチエンジンが解釈して自然なポーズを挿入します。
<Say> は事前に録音しておくことが難しい、動的なテキストの読み上げに使えます。<Say> の内容が静的なテキストの場合は、実際に人が読み上げる音声を録音し、 <Play> 動詞を使う方法もあります。
もし、長いポーズを入れたい場合は、<Pause>動詞を試してみてください。<Pause> は <Say> のタグの外に書かなければならず、中にネストしては使えません。

ヘルプが必要ですか？

誰しもが一度は考える「コーディングって難しい」。そんな時は、お問い合わせフォームから質問してください。または、Stack Overflow でTwilioタグのついた情報から欲しいものを探してみましょう。

Say動詞内での属性の使用
Say動詞内の属性として特定の言語を使用
アリスの声が既定となるSay動詞
Hello World
Hello, ブラジルポルトガル語でのHello

SDKバージョン:

形式:

TwiML

const VoiceResponse = require('twilio').twiml.VoiceResponse;

const response = new VoiceResponse();
response.say(
  {
    voice: 'woman',
    language: 'fr',
  },
  'Chapeau!'
);

console.log(response.toString());

using Twilio.TwiML;
using System;


class Example
{
    static void Main()
    {
        var response = new VoiceResponse();
        response.Say("Chapeau!", voice: "woman", language: "fr");

        Console.WriteLine(response.ToString());;
    }
}

<?php
require_once './vendor/autoload.php';
use Twilio\Twiml;

$response = new Twiml();
$response->say('Chapeau!', ['voice' => 'woman', 'language' => 'fr']);

echo $response;

require 'twilio-ruby'

response = Twilio::TwiML::VoiceResponse.new
response.say('Chapeau!', voice: 'woman', language: 'fr')

puts response

from twilio.twiml.voice_response import VoiceResponse, Say

response = VoiceResponse()
response.say('Chapeau!', voice='woman', language='fr')

print(response)

import com.twilio.twiml.TwiMLException;
import com.twilio.twiml.voice.Say;
import com.twilio.twiml.voice.Say.Language;
import com.twilio.twiml.VoiceResponse;

public class Example {
    public static void main(String[] args) {
        Say say = new Say.Builder("Chapeau!").voice(Say.Voice.WOMAN)
            .language(Language.FR_FR).build();
        VoiceResponse response = new VoiceResponse.Builder().say(say).build();

        try {
            System.out.println(response.toXml());
        } catch (TwiMLException e) {
            e.printStackTrace();
        }
    }
}

<?xml version="1.0" encoding="UTF-8"?>
<Response>
    <Say voice="woman" language="fr-FR">Chapeau!</Say>
</Response>

SDKバージョン:

形式:

TwiML

const VoiceResponse = require('twilio').twiml.VoiceResponse;

const response = new VoiceResponse();
response.say(
  {
    voice: 'alice',
    language: 'fr-FR',
  },
  'Chapeau!'
);

console.log(response.toString());

using Twilio.TwiML;
using System;


class Example
{
    static void Main()
    {
        var response = new VoiceResponse();
        response.Say("Chapeau!", voice: "alice", language: "fr-FR");

        Console.WriteLine(response.ToString());;
    }
}

<?php
require_once './vendor/autoload.php';
use Twilio\Twiml;

$response = new Twiml();
$response->say('Chapeau!', ['voice' => 'alice', 'language' => 'fr-FR']);

echo $response;

require 'twilio-ruby'

response = Twilio::TwiML::VoiceResponse.new
response.say('Chapeau!', voice: 'alice', language: 'fr-FR')

puts response

from twilio.twiml.voice_response import VoiceResponse, Say

response = VoiceResponse()
response.say('Chapeau!', voice='alice', language='fr-FR')

print(response)

import com.twilio.twiml.TwiMLException;
import com.twilio.twiml.voice.Say;
import com.twilio.twiml.voice.Say.Language;
import com.twilio.twiml.VoiceResponse;

public class Example {
    public static void main(String[] args) {
        Say say = new Say.Builder("Chapeau!").voice(Say.Voice.ALICE)
            .language(Language.FR_FR).build();
        VoiceResponse response = new VoiceResponse.Builder().say(say).build();

        try {
            System.out.println(response.toXml());
        } catch (TwiMLException e) {
            e.printStackTrace();
        }
    }
}

<?xml version="1.0" encoding="UTF-8"?>
<Response>
    <Say voice="alice" language="fr-FR">Chapeau!</Say>
</Response>

SDKバージョン:

形式:

TwiML

const VoiceResponse = require('twilio').twiml.VoiceResponse;

const response = new VoiceResponse();
response.say({
    language: 'sv-SE'
}, 'Hej!');

console.log(response.toString());

using Twilio.TwiML;
using System;


class Example
{
    static void Main()
    {
        var response = new VoiceResponse();
        response.Say("Hej!", language: "sv-SE");

        Console.WriteLine(response.ToString());;
    }
}

<?php
require_once './vendor/autoload.php';
use Twilio\Twiml;

$response = new Twiml();
$response->say('Hej!', ['language' => 'sv-SE']);

echo $response;

require 'twilio-ruby'

response = Twilio::TwiML::VoiceResponse.new
response.say('Hej!', language: 'sv-SE')

puts response

from twilio.twiml.voice_response import VoiceResponse, Say

response = VoiceResponse()
response.say('Hej!', language='sv-SE')

print(response)

import com.twilio.twiml.VoiceResponse;
import com.twilio.twiml.voice.Say;
import com.twilio.twiml.voice.Say.Language;
import com.twilio.twiml.TwiMLException;

public class Example {
    public static void main(String[] args) {
        Say say = new Say.Builder("Hej!").language(Language.SV_SE).build();
        VoiceResponse response = new VoiceResponse.Builder().say(say).build();

        try {
            System.out.println(response.toXml());
        } catch (TwiMLException e) {
            e.printStackTrace();
        }
    }
}

<?xml version="1.0" encoding="UTF-8"?>
<Response>
    <Say language="sv-SE">Hej!</Say>
</Response>

SDKバージョン:

形式:

TwiML

const VoiceResponse = require('twilio').twiml.VoiceResponse;

const response = new VoiceResponse();
response.say('Hello World');

console.log(response.toString());

using Twilio.TwiML;
using System;


class Example
{
    static void Main()
    {
        var response = new VoiceResponse();
        response.Say("Hello World");

        Console.WriteLine(response.ToString());;
    }
}

<?php
require_once './vendor/autoload.php';
use Twilio\Twiml;

$response = new Twiml();
$response->say('Hello World');

echo $response;

require 'twilio-ruby'

response = Twilio::TwiML::VoiceResponse.new
response.say('Hello World')

puts response

from twilio.twiml.voice_response import VoiceResponse, Say

response = VoiceResponse()
response.say('Hello World')

print(response)

import com.twilio.twiml.VoiceResponse;
import com.twilio.twiml.voice.Say;
import com.twilio.twiml.TwiMLException;


public class Example {
    public static void main(String[] args) {
        Say say = new Say.Builder("Hello World").build();
        VoiceResponse response = new VoiceResponse.Builder().say(say).build();

        try {
            System.out.println(response.toXml());
        } catch (TwiMLException e) {
            e.printStackTrace();
        }
    }
}

<?xml version="1.0" encoding="UTF-8"?>
<Response>
     <Say>Hello World</Say>
</Response>

SDKバージョン:

形式:

TwiML

const VoiceResponse = require('twilio').twiml.VoiceResponse;

const response = new VoiceResponse();
response.say(
  {
    voice: 'alice',
    language: 'pt-BR',
    loop: 2,
  },
  'Bom dia.'
);

console.log(response.toString());

using Twilio.TwiML;
using System;


class Example
{
    static void Main()
    {
        var response = new VoiceResponse();
        response.Say("Bom dia.", voice: "alice", language: "pt-BR", loop: 2);

        Console.WriteLine(response.ToString());;
    }
}

<?php
require_once './vendor/autoload.php';
use Twilio\Twiml;

$response = new Twiml();
$response->say('Bom dia.', ['voice' => 'alice', 'language' => 'pt-BR',
    'loop' => 2]);

echo $response;

require 'twilio-ruby'

response = Twilio::TwiML::VoiceResponse.new
response.say('Bom dia.', voice: 'alice', language: 'pt-BR', loop: 2)

puts response

from twilio.twiml.voice_response import VoiceResponse, Say

response = VoiceResponse()
response.say('Bom dia.', voice='alice', language='pt-BR', loop=2)

print(response)

import com.twilio.twiml.VoiceResponse;
import com.twilio.twiml.voice.Say;
import com.twilio.twiml.voice.Say.Language;
import com.twilio.twiml.TwiMLException;

public class Example {
    public static void main(String[] args) {
        Say say = new Say.Builder("Bom dia.").voice(Say.Voice.ALICE)
            .language(Language.PT_BR).loop(2).build();
        VoiceResponse response = new VoiceResponse.Builder().say(say).build();

        try {
            System.out.println(response.toXml());
        } catch (TwiMLException e) {
            e.printStackTrace();
        }
    }
}

<?xml version="1.0" encoding="UTF-8"?>
<Response>
     <Say voice="alice" language="pt-BR" loop="2">Bom dia.</Say>
</Response>

TwiML™ Voice： <Say>

フィードバックくださりありがとうございます！

Say動詞内での属性の使用

Say動詞内の属性として特定の言語を使用

アリスの声が既定となるSay動詞

Hello World

Hello, ブラジルポルトガル語でのHello

ヘルプが必要ですか？