Device.Active
Device.Append
Device.Buffer
Device.CODECsEnabled
Device.Count
Device.Delay
Device.ID
Device.List
Device.Name
Device.Pause
Device.Timeout
Device.Trim
ActiveX: etRecord.DeviceActive
Type: Boolean
When: Run-Time
Read/Write: Read and Write
Edition: Standard, Professional, Enterprise
<Click
here for example>
This property is used to start and stop recording a wave file. To begin recording set this property to True.
To stop recording, set the value to False. The audio device is freed and the wave data is saved to the file identified in the etLine.Source.FileName property. If a file already exists then it is overwritten.
Prior to setting the value of this property to True make sure that the etRecord.Device.ID and/or etRecord.Device.Name properties are set to the correct audio device. Also make sure that the etRecord.Source.FileName is set to a valid path and file name.
This property is also used to inspect the current state of the device. If the current value of this property is True then the audio device is currently allocated to this instance of etRecord and recording. If the value is False then the this instance of etRecord is not currently recording although another object or application may have the audio device allocated.
ActiveX: etRecord.DeviceAppend
Type: Boolean
When: Design-Time
Read/Write: Read and Write
Edition: Enterprise
ActiveX: etRecord.DeviceBuffer
Type: Integer
When: Design-Time and Run-Time
Read/Write: Read and Write
Edition: Standard, Professional, Enterprise
This property indicates the maximum number of milliseconds of a recording that an individual buffer
will hold.
The default is 1000 milliseconds (1 second) this works fine for most audio devices. Some audio devices will loose several milliseconds of recorded information when switching from one buffer to the next. For this reason you may hear a click or very breif period of silence at the interval of the buffer. Increase the value of this property in order to minumize this problem.
ActiveX: etRecord.DeviceCODECsEnabled
Type: Boolean
When: Design-Time
Read/Write: Read and Write
Edition: Standard, Professional, Enterprise
ActiveX: etRecord.DeviceCount
Type: Integer
When: Run-Time
Read/Write: Read Only
Edition: Standard, Professional, Enterprise
This is the number of wave record audio devices available through the multimedia functions of the
Windows operating system.
ActiveX: etRecord.DeviceDelay
Type: Integer
When: Design-Time and Run-Time
Read/Write: Read and Write
Edition: Standard, Professional, Enterprise
Some audio devices that are associated with a telephony device require a delay to allow the device
time to finish freeing its internal device and/or memory after playing a wave file. This is not needed
for most telephony hardware. The default value is 0. This value is in milliseconds.
ActiveX: etRecord.DeviceID
Type: Integer
When: Run-Time
Read/Write: Read and Write
Edition: Standard, Professional, Enterprise
<Click
here for example>
Set this property to indicate which Windows wave record audio device is to be used. Legal values for this property are 0 to etRecord.Device.Count -1. The etRecord.Device.Name property holds the name.
ITo record a wave file over the TAPI Line or TAPI Phone device, you must use the correct audio device. See the etRecord Overview for details.
ActiveX: etRecord.DeviceList
Type: TStrings
When: Run-Time
Read/Write: Read Only
Edition: Standard, Professional, Enterprise
This is a list of the available wave record audio devices according to the Windows operating system.
There are (Device.Count - 1) devices listed in the order of their ID value. The first device in the list
has an ID of 0, the last device has an ID of (Device.Count -1).
ActiveX: etRecord.DeviceName
Type: String
When: Run-Time
Read/Write: Read and Write
Edition: Standard, Professional, Enterprise
<Click
here for example>
This is the name of the device identified in the etRecord.Device.ID property. This property can also be set to the exact name of the wave audio device. If an exact match is found the the etRecord.Device.ID is updated.
This is useful for your application configuration bacause the name of the device is less likely to change than the device ID. The device ID is assigned by the Windows operating system and may change if other devices are added or deleted. For example, save the Device.Name property when exiting your application. When starting your application retrieve the stored name and set this property.
ActiveX: etRecord.DevicePause
Type: Boolean
When: Design-Time and Run-Time
Read/Write: Read Only
Edition: Professional, Enterprise
Set this property to True to pause recording then false to continue recording. The audio device remains
allocated when it is paused.
ActiveX: etRecord.DeviceTimeout
Type: Integer
When: Design-Time and Run-Time
Read/Write: Read and Write
Edition: Standard, Professional, Enterprise
Many audio functions work in an asynchronous fashion meaning that the when a function is called it
returns immediately although the operation will not be complete until a reply message is sent to the application.
TeleTools insulates you from these types of functions by stalling your code execution until the message
is returned. This time period is most often just a few milliseconds so you will not notice that it is
happening. In case of an error we have added a timeout feature that will ensure that TeleTools does not
hang your application in the case that the reply message is not returned.
The value for this property is in milliseconds. The default value is 4000 (4 seconds).
ActiveX: etRecord.DeviceTrim
Type: Integer
When: Design-Time and Run-Time
Read/Write: Read and Write
Edition: Standard, Professional, Enterprise
This property will cause the wave data to be trimmed at the end of the recording by the number of
milliseconds defined in this property. Trim is performed when the data is saved to a file (See the property
etRecord.Device.Active).
This is useful in situtations where an application instructs a users to press a button on the phone to end recording. In this case the DTMF tone would be recorded. Setting this property to 250 (1/4 second) or 500 (1/2 second) may be enough to remove the tone from the recording.
|
|