Howto:Convert wave files in to G7xx coder files: Difference between revisions

From innovaphone wiki
Jump to navigation Jump to search
No edit summary
 
(34 intermediate revisions by 11 users not shown)
Line 1: Line 1:
The HTTP interface allows to play sound files delivered from a web server.
<!-- How to convert wave files in to G7xx coder codec files for the HTTP interface -->
The HTTP interface allows to play sound files delivered from a web server. This is used mostly for music on hold or waiting queue announcements. These files need to be in a specific format, not standard wave file. Here is how to convert a standard wave file into this format.


This is used mostly for music on hold or waiting queue announcements.  
This '''method is deprecated''' - rather use the innovaphone audio converter located at http://www.innovaphone.com/en/support/convert.html


These files need to be in a specific format, not standard wave file. 
==Applies To==
This information applies to


Here is how to convert a standard wave file into this format.
*  All innovaphone gateways (IP202, IP302,IP305 ,IP800, IP3000, IP6000, etc.)


Version V6 sr1
Version 5.0 up to v11r2This feature has been '''discontinued with v12r1'''.
Starting from V6 Sr1 it is possible to run the sound files via the Cf cardslot (no etxternal web server needed) please refer to the related articels below.
Also it is then possible to automaticly convert the wav files into g7xx  at the cf card
8khz, 16bit, mono *.wav files can be copied to webdav-mountable
  x.x.x.x/drive/CX0, in order to convert to *.g711a, *.g711u, *.g729.
Please be patient - a 2.5MB file (2.5min audio content) takes on an ip800
~15min to be converted into a *.g729 file.


==Applies To==
==More Information==
This information applies to
 
'''New (since 2014)''': Below mentioned process becomes obsolete by using the innovaphone audio converter located at [http://www.innovaphone.com/en/support/convert.html the innovaphone homepage].


*  All innovaphone gateways (IP202, IP302,IP305 ,IP800, IP3000, IP6000)
Creation of any source files to be converted may take place via any audio modification tool (e.g. Audacity) to mix several audio samples.


Version 5.0 and later.
Transfer of converted files to the CF-card is still done using any webdav file transfer application (e.g. NetDrive, BitKinex, WindowsExplorer, ...).


==More Information==
<hr>


===Problem Details===
===Problem Details===
To avoid just-in-time format conversion and/or encoding, sound files played via the HTTP interface must be present as coder-specific raw sound stream data files.  
To avoid just-in-time format conversion and/or encoding, sound files played via the HTTP interface must be present as coder-specific raw sound stream data files. To use a standard wave file, it must be converted into G711/G723/G729 format first. Also, if you want to provide a specific sound file for calls with different coders, you must provide a single version of such file for each coder in question. To create G723, G729, G711a or G711u files, you will need standard 8kHz, 16bit, mono wave files.
At the [http://download.innovaphone.com/ice/6.00/ download site] you will find the softcod.exe in the tools folder. This is a command line utility which will convert such a wave file to the required coder files.


To use a standard wave file, it must be converted into this format first. 


Also, if you want to provide a specific sound file for calls with different coders, you must provide a single version of such file for each coder in question.
To convert a wave file announcement.wav, call at command line:
softcod announcement.wav


To create G723, G729, G711a or G711m files, you will need standard 8kHz, 16bit, mono wave files.  
Softcode will create announcement.g723, announcement.g729, announcement.g711a and announcement.g711u.
 
At the download site you will find the softcod.exe in the tools folder command line utility which will convert such a wave file to the required coder files.
 
Due to licensing issues, the conversion process requires access to an innovaphone gateway. The tool will thus ask for a valid gatekeeper/pbx alias. Note that the tool must be able to register with this alias. Therefore, you cannot use an account which is currently in use. As the tool will not ask for a password, you cannot use an account which is password protected.


To convert a wave file announcement.wav, call
===Installation===
There is no install available or required. Simply call softcod.exe from the command line.


softcod announcement.wav
===Known Problems===
The tool will locate the gatekeeper/pbx using gatekeeper discovery. Note that this currently will not work on multi-homed hosts, that is, hosts with more than one (virtual or physical) network interface. Most available wave file tools will not create wave files in the proper format (as defined above). In order for softcod.exe to work, you have to make sure the input wave file is in the proper format. Depending on the tool you are using, you may need to change the files audio properties. Also, you may use Windows™ standard audiorecorder application (sndrec32.exe) to convert a wave file in to the proper format (use File/Properties/Convert).


this will create announcement.g723, announcement.g729, announcement.g711a and announcement.g711u. 
== New since V6 SR1 ==
Starting from V6 Sr1 it is possible to run the sound files via the Cf cardslot (no external web server needed) please refer to the related articles below.


Due to licensing issues, the conversion process requires access to an innovaphone gateway. 
'''! This method does not work when running a Linux Application Platform on this CF !'''


The tool will thus ask for a valid gatekeeper/pbx alias.
Also it is then possible to automaticly convert the wav files into g7xx  on the built-in compact flash card without using softcod.


Note that the tool must be able to register with this alias.
8khz, 16bit, mono *.wav files can be copied to webdav-mountable '''\\''x.x.x.x''\drive\CX0''', in order to convert to *.g711a, *.g711u, *.g729.
Please use the the '''Internet Explorer''' to open the directory on the CF.  


Therefore, you cannot use an account which is currently in use.
First, the access to the cf-card must be enabled. For this make relevant settings under "General, HTTP server, CompactFlash public access".
For example: "/DRIVE/CX0/" "read" and "write"


As the tool will not ask for a password, you cannot use an account which is password protected
Go with '''Internet Explorer''' to '''"Administration, Diagnostics, CF"''' and choose the option '''"Browse CF Content (Explorer, IE only)"'''. In the Internet Explorer the line '''\\''x.x.x.x''\drive\CF0''' is appearing.
Change in the URL '''CF0''' to '''CX0'''. The URL is then looking like '''\\''x.x.x.x''\drive\CX0''' (also to mount a network drive).


===Installation===
Use now drag&drop to copy the wav file to the directory on the Compact Flash card.
There is no install available or required.


Simply call softcod.exe from the command line
[[Image:Convert_wave_files_in_to_G7xx_coder_files 1.PNG]]
===Known Problems===


The tool will locate the gatekeeper/pbx using gatekeeper discovery.
After a succesfull conversion, you should have a similar file structure on your CF card.


Note that this currently will not work on multi-homed hosts, that is, hosts with more than one (virtual or physical) network interface.
However, please be patient - a 2.5MB file (2.5min audio content) takes on an ip800 ~15min to be converted into a *.g729 file.


Most available wave file tools will not create wave files in the proper format (as defined above).   
== For GNU/Linux ... ==
{{Template:3rd Party Input}}
Very nice tool called [http://webdav.org/cadaver/ cadaver] - it's a command line WebDAV client - it supports up- and download, move/copy/delete/list etc.


In order for softcod.exe to work, you have to make sure the input wave file is in the proper format. 
== Convert other file formats ==


Depending on the tool you are using, you may need to change the files audio properties. 
To use other source file formats (such as mp3 etc), following a small instruction how to do so:


Also, you may use Windows™ standard audiorecorder application (sndrec32.exe) to convert a wave file in to the proper format (use File/Properties/Convert).
* [http://audacity.sourceforge.net/ Download audio-converter] '''Audacity'''
* Start Audacity and open the source-file to be converted. This can be mp3, wav, aiff, flac, ogg-vorbis(?), ffmpeg-compatible formatted.
[[Image:Audacity_open_file.png]]
* Select in the below-left corner a '''projectfrequency of 8000Hz'''
[[Image:Audacity_frequency.png]]
* Click on File / Export and choose as output file format '''WAV (Microsoft) 16-bit PCM''' and store
[[Image:Audacity_export.png]]


Then proceed with the resulting WAV files as [[#New since V6 SR1|described above]] for conversion in g7xx formats.


== Related Articles ==
== Related Articles ==


[http://download.innovaphone.com/6.00/ download site]
[http://download.innovaphone.com/ice/6.00/ Download softcode (included in the ''Tools'' Package)]
 
[[Howto:Installing_the_voicemail/music_on_hold_on_a_compact_flash_card]]


[http://wiki.innovaphone.com/index.php?title=Howto:Installing_the_voicemail/music_on_hold_on_a_compact_flash_card music on hold on cf card]
[[Howto:General_information_for_compact_flash_cards]]


[http://wiki.innovaphone.com/index.php?title=Howto:General_information_for_compact_flash_cards general info about the compat flash cards]
[[Howto:Convert wave files to G7xxx with softcode]]


[[Howto:Convert wave files in to G722 coder files]]


[[Category:Howto|{{PAGENAME}}]]
[[Category:Howto|{{PAGENAME}}]]

Latest revision as of 15:45, 21 January 2016

The HTTP interface allows to play sound files delivered from a web server. This is used mostly for music on hold or waiting queue announcements. These files need to be in a specific format, not standard wave file. Here is how to convert a standard wave file into this format.

This method is deprecated - rather use the innovaphone audio converter located at http://www.innovaphone.com/en/support/convert.html

Applies To

This information applies to

  • All innovaphone gateways (IP202, IP302,IP305 ,IP800, IP3000, IP6000, etc.)

Version 5.0 up to v11r2. This feature has been discontinued with v12r1.

More Information

New (since 2014): Below mentioned process becomes obsolete by using the innovaphone audio converter located at the innovaphone homepage.

Creation of any source files to be converted may take place via any audio modification tool (e.g. Audacity) to mix several audio samples.

Transfer of converted files to the CF-card is still done using any webdav file transfer application (e.g. NetDrive, BitKinex, WindowsExplorer, ...).


Problem Details

To avoid just-in-time format conversion and/or encoding, sound files played via the HTTP interface must be present as coder-specific raw sound stream data files. To use a standard wave file, it must be converted into G711/G723/G729 format first. Also, if you want to provide a specific sound file for calls with different coders, you must provide a single version of such file for each coder in question. To create G723, G729, G711a or G711u files, you will need standard 8kHz, 16bit, mono wave files.

At the download site you will find the softcod.exe in the tools folder. This is a command line utility which will convert such a wave file to the required coder files.


To convert a wave file announcement.wav, call at command line:

softcod announcement.wav

Softcode will create announcement.g723, announcement.g729, announcement.g711a and announcement.g711u.


Due to licensing issues, the conversion process requires access to an innovaphone gateway. The tool will thus ask for a valid gatekeeper/pbx alias. Note that the tool must be able to register with this alias. Therefore, you cannot use an account which is currently in use. As the tool will not ask for a password, you cannot use an account which is password protected.

Installation

There is no install available or required. Simply call softcod.exe from the command line.

Known Problems

The tool will locate the gatekeeper/pbx using gatekeeper discovery. Note that this currently will not work on multi-homed hosts, that is, hosts with more than one (virtual or physical) network interface. Most available wave file tools will not create wave files in the proper format (as defined above). In order for softcod.exe to work, you have to make sure the input wave file is in the proper format. Depending on the tool you are using, you may need to change the files audio properties. Also, you may use Windows™ standard audiorecorder application (sndrec32.exe) to convert a wave file in to the proper format (use File/Properties/Convert).

New since V6 SR1

Starting from V6 Sr1 it is possible to run the sound files via the Cf cardslot (no external web server needed) please refer to the related articles below.

! This method does not work when running a Linux Application Platform on this CF !

Also it is then possible to automaticly convert the wav files into g7xx on the built-in compact flash card without using softcod.

8khz, 16bit, mono *.wav files can be copied to webdav-mountable \\x.x.x.x\drive\CX0, in order to convert to *.g711a, *.g711u, *.g729. Please use the the Internet Explorer to open the directory on the CF.

First, the access to the cf-card must be enabled. For this make relevant settings under "General, HTTP server, CompactFlash public access". For example: "/DRIVE/CX0/" "read" and "write"

Go with Internet Explorer to "Administration, Diagnostics, CF" and choose the option "Browse CF Content (Explorer, IE only)". In the Internet Explorer the line \\x.x.x.x\drive\CF0 is appearing. Change in the URL CF0 to CX0. The URL is then looking like \\x.x.x.x\drive\CX0 (also to mount a network drive).

Use now drag&drop to copy the wav file to the directory on the Compact Flash card.

Convert wave files in to G7xx coder files 1.PNG

After a succesfull conversion, you should have a similar file structure on your CF card.

However, please be patient - a 2.5MB file (2.5min audio content) takes on an ip800 ~15min to be converted into a *.g729 file.

For GNU/Linux ...

3rd party input
this is 3rd party content not provided by innovaphone, see history for authors.

Very nice tool called cadaver - it's a command line WebDAV client - it supports up- and download, move/copy/delete/list etc.

Convert other file formats

To use other source file formats (such as mp3 etc), following a small instruction how to do so:

  • Download audio-converter Audacity
  • Start Audacity and open the source-file to be converted. This can be mp3, wav, aiff, flac, ogg-vorbis(?), ffmpeg-compatible formatted.

Audacity open file.png

  • Select in the below-left corner a projectfrequency of 8000Hz

Audacity frequency.png

  • Click on File / Export and choose as output file format WAV (Microsoft) 16-bit PCM and store

Audacity export.png

Then proceed with the resulting WAV files as described above for conversion in g7xx formats.

Related Articles

Download softcode (included in the Tools Package)

Howto:Installing_the_voicemail/music_on_hold_on_a_compact_flash_card

Howto:General_information_for_compact_flash_cards

Howto:Convert wave files to G7xxx with softcode

Howto:Convert wave files in to G722 coder files