core: document difference between IO and main thread view on requested latency
[platform/upstream/pulseaudio.git] / PROTOCOL
1 ### v8, implemented by >= 0.8
2
3 First version supported.
4
5 ### v9, implemented by >= 0.9.0
6
7 Reply for PA_COMMAND_CREATE_PLAYBACK_STREAM,
8 PA_COMMAND_CREATE_RECORD_STREAM now returns buffer_attrs that are used:
9
10 Four new fields in reply of PA_COMMAND_CREATE_PLAYBACK_STREAM:
11
12    maxlength
13    tlength
14    prebuf
15    minreq
16
17 Two new fields in reply of PA_COMMAND_CREATE_RECORD_STREAM:
18
19    maxlength
20    fragsize
21
22 ### v10, implemented by >= 0.9.5
23
24 New opcodes:
25
26  PA_COMMAND_MOVE_SINK_INPUT
27  PA_COMMAND_MOVE_SOURCE_OUTPUT
28
29 SHM data transfer support
30
31 ### v11, implemented by >= 0.9.7
32
33 Reply to to PA_COMMAND_GET_SINK_INPUT_INFO, PA_COMMAND_GET_SINK_INPUT_INFO_LIST gets new field at the end:
34
35  mute
36
37 New opcodes:
38
39  PA_COMMAND_SET_SINK_INPUT_MUTE
40  PA_COMMAND_SUSPEND_SINK
41  PA_COMMAND_SUSPEND_SOURCE
42
43 ### v12, implemented by >= 0.9.8
44
45 S32LE, S32BE is now known as sample spec.
46
47 Gained six new bool fields for PA_COMMAND_CREATE_PLAYBACK_STREAM, PA_COMMAND_CREATE_RECORD_STREAM request at the end:
48
49  no_remap_channels
50  no_remix_channels
51  fix_format
52  fix_rate
53  fix_channels
54  no_move
55  variable_rate
56
57 Reply to these opcodes now includes:
58
59  sample_spec
60  channel_map
61  device_index
62  device_name
63  suspended
64
65 New opcodes for changing buffer attrs:
66
67  PA_COMMAND_SET_PLAYBACK_STREAM_BUFFER_ATTR
68  PA_COMMAND_SET_RECORD_STREAM_BUFFER_ATTR
69
70 New opcodes for changing sampling rate:
71
72  PA_COMMAND_UPDATE_PLAYBACK_STREAM_SAMPLE_RATE
73  PA_COMMAND_UPDATE_RECORD_STREAM_SAMPLE_RATE
74
75 New opcodes for notifications:
76
77  PA_COMMAND_PLAYBACK_STREAM_SUSPENDED
78  PA_COMMAND_CAPTURE_STREAM_SUSPENDED
79  PA_COMMAND_PLAYBACK_STREAM_MOVED
80  PA_COMMAND_CAPTURE_STREAM_MOVED
81
82 ### v13, implemented by >= 0.9.11
83
84 New fields for PA_COMMAND_CREATE_PLAYBACK_STREAM, PA_COMMAND_CREATE_RECORD_STREAM request at the end:
85
86  peak_detect (bool)
87  adjust_latency  (bool)
88
89 Replace field "name" for PA_COMMAND_CREATE_PLAYBACK_STREAM, PA_COMMAND_CREATE_RECORD_STREAM at the end:
90
91  proplist
92
93 Replace field "name" for PA_COMMAND_SET_CLIENT_NAME request at the end:
94
95  proplist
96
97 On response of PA_COMMAND_SET_CLIENT_NAME:
98
99  client_index
100
101 New proplist field for sink, source, sink input, source output introspection opcodes and at the end:
102
103  proplist
104
105 New opcodes for proplist modifications
106
107   PA_COMMAND_UPDATE_RECORD_STREAM_PROPLIST
108   PA_COMMAND_UPDATE_PLAYBACK_STREAM_PROPLIST
109   PA_COMMAND_UPDATE_CLIENT_PROPLIST
110   PA_COMMAND_REMOVE_RECORD_STREAM_PROPLIST
111   PA_COMMAND_REMOVE_PLAYBACK_STREAM_PROPLIST
112   PA_COMMAND_REMOVE_CLIENT_PROPLIST
113
114 New field for PA_COMMAND_PLAY_SAMPLE:
115
116   proplist
117
118 New field for PA_COMMAND_PLAY_SAMPLE response:
119
120   idx
121
122 New field for PA_COMMAND_CREATE_PLAYBACK_STREAM at the end:
123
124   start_muted
125
126 Buffer attributes for PA_COMMAND_CREATE_PLAYBACK_STREAM and
127 PA_COMMAND_CREATE_RECORD_STREAM may now be 0 for default values.
128
129 New field for PA_COMMAND_SET_PLAYBACK_STREAM_BUFFER_ATTR,
130 PA_COMMAND_SET_RECORD_STREAM_BUFFER_ATTR at the end:
131
132   adjust_latency (bool)
133
134 new message:
135
136   PA_COMMAND_STARTED
137
138 ### v14, implemented by >= 0.9.12
139
140 new message:
141
142   PA_COMMAND_EXTENSION
143
144 PA_COMMAND_CREATE_PLAYBACK_STREAM:
145
146   bool volume_set at the end
147
148 PA_COMMAND_CREATE_RECORD_STREAM, PA_COMMAND_CREATE_PLAYBACK_STREAM:
149
150   bool early_requests at the end
151
152 New field for PA_COMMAND_SET_PLAYBACK_STREAM_BUFFER_ATTR,
153 PA_COMMAND_SET_RECORD_STREAM_BUFFER_ATTR at the end:
154
155   early_requests (bool)
156
157 ### v15, implemented by >= 0.9.15
158
159 PA_COMMAND_CREATE_PLAYBACK_STREAM
160
161   bool muted at the end
162
163 PA_COMMAND_CREATE_PLAYBACK_STREAM, PA_COMMAND_CREATE_RECORD_STREAM:
164
165   bool dont_inhibit_auto_suspend at the end
166
167 PA_COMMAND_GET_MODULE_INFO_LIST
168
169   remove bool auto_unload
170   add proplist at the end
171
172 new messages:
173
174   PA_COMMAND_GET_CARD_INFO
175   PA_COMMAND_GET_CARD_INFO_LIST
176   PA_COMMAND_SET_CARD_PROFILE
177
178   PA_COMMAND_CLIENT_EVENT
179   PA_COMMAND_PLAYBACK_STREAM_EVENT
180   PA_COMMAND_RECORD_STREAM_EVENT
181
182   PA_COMMAND_PLAYBACK_BUFFER_ATTR_CHANGED
183   PA_COMMAND_RECORD_BUFFER_ATTR_CHANGED
184
185 ### v16, implemented by >= 0.9.15
186
187 new messages:
188
189   PA_COMMAND_SET_SINK_PORT
190   PA_COMMAND_SET_SOURCE_PORT