Product:

ZDK

Category:

Data

Subject:

Data Quality Request

Page:

1 of 1


Data Quality Request

You can not be sure of the capabilities of the far end prior to establishing a call. The modes and channel sizes supported by the far end are unknown until the call is actually made. There is an exchange of capabilities after connection. A list is created of what is supported. A 128K data mode cannot be specified prior to connection as it may not be supported. But when a call is established, a mode must be selected for the call.

To solve this problem the classes and custom controls contain a concept called the Quality Request. For Video, Audio, and Data the application requests the quality needed for a call. These are given in general terms, such as smallest, best or smart. When a call is established the quality request instructs the class how set up the channel allocations.

The complete list of data quality requests is:

C++

Custom Control

Value

DATA_ALG_NODATA

ZYD_BANDWIDTH_OFF

0

DATA_ALG_SLOWEST

ZYD_BANDWIDTH_LOW

1

DATA_ALG_SMART

ZYD_BANDWIDTH_SMART

2

DATA_ALG_FASTEST

ZYD_BANDWIDTH_HIGH

3

DATA_ALG_MIRROR

ZYD_BANDWIDTH_MIRROR

4

 

Selecting no data (DATA_ALG_NODATA) will not allocate any video bandwidth for the data.

Selecting mirror mode (DATA_ALG_MIRROR) will allocate the amount of data that the far end allocates.

Smart data (DATA_ALG_SMART) works with smart audio (AUDIO_ALG_SMART) to assemble the highest data bandwidth supported by both sides. If no file transfer is being performed, or no serial port is emulated, the data bandwidth allocation is zero. When one of these operations is performed, smart data starts to reassemble the bandwidth allocations to optimize the data. If smart audio is selected, audio is brought down to the lowest size audio mode available, else audio is left alone. The listing of supported data modes is searched. In searching, 32K is reserved for the video. The highest data mode is then selected and set.

There is one exception to the above algorithm for smart data - the sending of notes or text. To optimize the speed of sending notes, the data mode is set to the lowest data mode and audio is left alone. When smart data is finished, it will bring the data channel back to zero length and restore smart audio to its previous mode.

The functions associated with the video request are:

CZ_Call::GetSendDataQuality();

CZ_Call::SetSendDataQuality();

In the custom control the property to set is:

DataRequest

The Affects of Smart Data

Smart Data is the expert sub-system of the Zydacron classes. When smart data is selected, and an event happens which involves data, Smart Data will examine the situation and determine the best way to reconfigure the phone call to optimize the data operations of the call. When smart data is selected, and there is no data operation active, the data is set to off (or a size of 0.)

Smart Data works with Smart Audio. If Smart Audio is selected, the audio is set to high fidelity when the call is created. When a data operation is performed, Smart Data will see that Smart Audio is selected and may bring audio down to low fidelity to provide for a larger data size.

Here are some scenarios and how Smart Data reacts:

 


Last reviewed: 11-Sep-97

THE INFORMATION PROVIDED BY ZYDACRON IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. ZYDACRON EXPRESSLY DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.

©1997 Zydacron, Inc. All rights reserved. Legal Notices.