AudioOutputUpdate

From TrillWiki

The audioOutputUpdate function allows you to change options on an audio session.

Compatibility: 3.0 and higher

Contents 1 Syntax 2 Parameters 3 Return Value 4 Remarks

Syntax

plugin_send(MYGUID,"audioOutputUpdate",audio_t *);

Note that all Trillian functions and notifications begin with a lower-case letter, despite the Wiki requirement that all pages start with a capital letter.

Parameters

AudioOutputUpdate utilitizes the audio_t structure.

struct audio_t 
{ 
    unsigned int                struct_size; 

    int                         connection_id;
    int                         window_id;

    char                        *medium;
    char                        *name;
    char                        *location;

    char                        *section;

    int                         initiated;
    int                         ask_confirmation;

    /* Audio Information
     */

    int                         codec; 

    int                         audio_sample_size;
    int                         audio_sample_rate;
    int                         audio_block_size;
    int                         audio_quality;

    int                         audio_data_length; 

    unsigned char               *audio_data; 

    ttkCallback                 callback; 
    void                        *data; 
};

window_id

The window ID whose audio input stream is being reconfigured.)

codec

What audio codec to use. As of 3.0, only AUDIO_CODEC_UNCOMPRESSED and AUDIO_CODEC_TRUESPEECH are supported.

audio_sample_size

Size of each sample, in bits.

audio_sample_rate

Number of samples per second.

audio_block_size

How many samples Trillian should collect before notifying the callback below.

audio_quality

The target audio quality, from 1-100 percent. Lower quality is lower CPU impact.

Return Value

This function returns 0 on success, or a negative value on error.

Remarks

None.