library ibm-watson-tts

tbetool/ibm-watson-tts

Based on IBM Watson. Text to Speech serializer

IBM Watson Text-To-Speech PHP Library

Convert written text into natural-sounding audio in a variety of languages and voices.
This package use IBM Watson Text To Speech service., _(*1)

Using the Library

Installation

Intall library in PHP project using composer, _(*2)

composer require tbetool/ibm-watson-tts

Using Library

After installing the library, create WatsonTts object, _(*3)

$watson = new WatsonTts(
    'watson_username', 
    'watson_password', 
    'watson_url'
);

Watson username, password, url can be obtained by creating an instance of service. For more detail follow Getting Started Guide., _(*4)

Setting output path

Set absolute path of the directory where to save the output. You don't need to provide a file name as it will be auto generated., _(*5)

$path = '/aboslute/path/to/directory';

$watson->setOutputPath($path);

Convert Text to Speech

Pass text to convert to speech., _(*6)

$file = $watson->tts('Hello World');

This will return the absolute path of the file created if text to speech conversion is successful, otherwise will throw Exception., _(*7)

Exception handling

Every function throws an Exception in case of any error/issue. Bind the code block within try-catch block to catch any exception occurred., _(*8)

Ex:, _(*9)

try {
    $watson->setAudioFormat('mp3');
} catch (Exception $exception) {
    echo $exception->getMessage();
}

will throw and exception Not a valid audio format. Allowed formats: wav, ogg as mp3 audio format is not supported as of now, _(*10)

Other callable methods

Set Audio Format

$watson->setAudioFormat('wav');

allowed formats: wav, ogg
default: wav, _(*11)

Set Language

$watson->setLanguage('en-US');

allowed languages: See List   default: en-US, _(*12)

Set Voice

$watson->setVoice('MichaelVoice');

allowed voices: See List
default: MichaelVoice, _(*13)

Supported language and voice list

list of supported language and voice strings, _(*14)

Bug Reporting

If you found any bug, create an issue., _(*15)

Support and Contribution

Something is missing? * Fork the repositroy * Make your contribution * make a pull request, _(*16)