1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
|
/*
* Copyright (C) Volition, Inc. 1999. All rights reserved.
*
* All source code herein is the property of Volition, Inc. You may not sell
* or otherwise commercially exploit the source or things you created based on the
* source.
*
*/
#ifndef _MULTIPLAYER_VOICE_STREAMING_HEADER_FILE
#define _MULTIPLAYER_VOICE_STREAMING_HEADER_FILE
// --------------------------------------------------------------------------------------------------
// MULTI VOICE DEFINES/VARS
//
struct header;
// voice system status defines
#define MULTI_VOICE_STATUS_IDLE 0 // nothing's happening, do nothing
#define MULTI_VOICE_STATUS_DENIED 1 // have been denied the token (show a red icon or something)
#define MULTI_VOICE_STATUS_RECORDING 2 // am currently recording (show a green icon or something)
#define MULTI_VOICE_STATUS_PLAYING 3 // playing back a stream (show another icon)
// max recording time for one stream
#define MULTI_VOICE_MAX_TIME 5000
// capabilities of this machine (make sure multi_voice_init() is called before referencing these)
extern int Multi_voice_can_record;
extern int Multi_voice_can_play;
// local muting preferences
extern int Multi_voice_local_prefs;
// --------------------------------------------------------------------------------------------------
// MULTI VOICE FUNCTIONS
//
// initialize the multiplayer voice system
void multi_voice_init();
// shutdown the multiplayer voice system
void multi_voice_close();
// reset between levels
void multi_voice_reset();
// process all voice details
void multi_voice_process();
// set the default voice quality and duration (if server passes -1, he just broadcasts the qos to all clients)
void multi_voice_set_vars(int qos,int duration);
// voice settings debug console function
void multi_voice_dcf();
// update the qos and/or duration of recording if the current setting is different from the passed in value
void multi_voice_maybe_update_vars(int new_qos,int new_duration);
// the status of the voice system - use this to determine what bitmaps to display, etc see above MULTI_VOICE_STATUS_* defines
int multi_voice_status();
// <player> sends hit bitflag settings (who he'll receive sound from, etc)
void multi_voice_set_prefs(int pref_flags);
// --------------------------------------------------------------------------------------------------
// MULTI VOICE / RTVOICE INTERFACE
//
// process the "next" chunk of standalone valid sound data from the rtvoice system
void multi_voice_process_next_chunk();
// --------------------------------------------------------------------------------------------------
// MULTI VOICE PACKET HANDLERS
//
// process an incoming voice packet of some kind or another
void multi_voice_process_packet(unsigned char *data, header *hinfo);
// --------------------------------------------------------------------------------------------------
// MULTI VOICE TESTING FUNCTIONS
//
// start recording voice locally for playback testing
void multi_voice_test_record_start();
// return if the test recording is going on
int multi_voice_test_recording();
// call this function if multi_voice_test_recording() is true to process various odds and ends of the test recording
void multi_voice_test_process();
// force stop any recording voice test
void multi_voice_test_record_stop();
// get a playback buffer handle (return -1 if none exist - bad)
int multi_voice_test_get_playback_buffer();
// return whether the last sampled chunk would have been too large to fit in a packet
int multi_voice_test_packet_tossed();
#endif
|
