@@ -3447,7 +3447,7 @@ <h4 id="response">Response</h4>
34473447< h2 id ="register-method "> < em > register < a href ="#head_Methods "> < sup > method</ sup > </ a > </ em > </ h2 >
34483448< p > Registers for an asynchronous JSON-RPC notification.</ p >
34493449< h3 id ="description_2 "> Description</ h3 >
3450- < p > This method supports the following event names: < em > < a href ="#notification_audioframe " > audioframe </ a > , < a href ="#notification_audiotransmission " > audiotransmission </ a > </ em > .</ p >
3450+ < p > This method supports the following event names: < em > < a href ="#notification_audiotransmission " > audiotransmission </ a > , < a href ="#notification_audioframe " > audioframe </ a > </ em > .</ p >
34513451< h3 id ="parameters_1 "> Parameters</ h3 >
34523452< table >
34533453< thead >
@@ -3536,7 +3536,7 @@ <h4 id="response_1">Response</h4>
35363536< h2 id ="unregister-method "> < em > unregister < a href ="#head_Methods "> < sup > method</ sup > </ a > </ em > </ h2 >
35373537< p > Unregisters from an asynchronous JSON-RPC notification.</ p >
35383538< h3 id ="description_3 "> Description</ h3 >
3539- < p > This method supports the following event names: < em > < a href ="#notification_audioframe " > audioframe </ a > , < a href ="#notification_audiotransmission " > audiotransmission </ a > </ em > .</ p >
3539+ < p > This method supports the following event names: < em > < a href ="#notification_audiotransmission " > audiotransmission </ a > , < a href ="#notification_audioframe " > audioframe </ a > </ em > .</ p >
35403540< h3 id ="parameters_2 "> Parameters</ h3 >
35413541< table >
35423542< thead >
@@ -4185,18 +4185,21 @@ <h1 id="notifications">Notifications</h1>
41854185</ thead >
41864186< tbody >
41874187< tr >
4188- < td style ="text-align: left; "> < a href ="#notification_audioframe "> audioframe</ a > </ td >
4189- < td style ="text-align: left; "> Provides audio data</ td >
4190- </ tr >
4191- < tr >
41924188< td style ="text-align: left; "> < a href ="#notification_audiotransmission "> audiotransmission</ a > </ td >
41934189< td style ="text-align: left; "> Signals state of the stream</ td >
41944190</ tr >
4191+ < tr >
4192+ < td style ="text-align: left; "> < a href ="#notification_audioframe "> audioframe</ a > </ td >
4193+ < td style ="text-align: left; "> Provides audio data</ td >
4194+ </ tr >
41954195</ tbody >
41964196</ table >
4197- < p > < a id ="notification_audioframe "> </ a > </ p >
4198- < h2 id ="audioframe-notification "> < em > audioframe < a href ="#head_Notifications "> < sup > notification</ sup > </ a > </ em > </ h2 >
4199- < p > Provides audio data.</ p >
4197+ < p > < a id ="notification_audiotransmission "> </ a > </ p >
4198+ < h2 id ="audiotransmission-notification "> < em > audiotransmission < a href ="#head_Notifications "> < sup > notification</ sup > </ a > </ em > </ h2 >
4199+ < p > Signals state of the stream.</ p >
4200+ < blockquote >
4201+ < p > This notification may also be triggered by client registration.</ p >
4202+ </ blockquote >
42004203< h3 id ="notification-parameters "> Notification Parameters</ h3 >
42014204< table >
42024205< thead >
@@ -4215,28 +4218,52 @@ <h3 id="notification-parameters">Notification Parameters</h3>
42154218< td style ="text-align: left; "> < em > ...</ em > </ td >
42164219</ tr >
42174220< tr >
4218- < td style ="text-align: left; "> params?.seq</ td >
4219- < td style ="text-align: left; "> integer</ td >
4221+ < td style ="text-align: left; "> params.state</ td >
4222+ < td style ="text-align: left; "> string</ td >
4223+ < td style ="text-align: left; "> mandatory</ td >
4224+ < td style ="text-align: left; "> New state of the stream (must be one of the following: < em > Idle, Started, Unavailable</ em > )</ td >
4225+ </ tr >
4226+ < tr >
4227+ < td style ="text-align: left; "> params?.profile</ td >
4228+ < td style ="text-align: left; "> object</ td >
42204229< td style ="text-align: left; "> optional</ td >
4221- < td style ="text-align: left; "> Frame number in current transmission </ td >
4230+ < td style ="text-align: left; "> Details on the format used in the stream </ td >
42224231</ tr >
42234232< tr >
4224- < td style ="text-align: left; "> params?.timestamp</ td >
4225- < td style ="text-align: left; "> integer</ td >
4233+ < td style ="text-align: left; "> params?.profile.codec</ td >
4234+ < td style ="text-align: left; "> string</ td >
4235+ < td style ="text-align: left; "> mandatory</ td >
4236+ < td style ="text-align: left; "> Compression method (PCM: uncompressed) (must be one of the following: < em > IMA-ADPCM, PCM</ em > )</ td >
4237+ </ tr >
4238+ < tr >
4239+ < td style ="text-align: left; "> params?.profile?.codecparams</ td >
4240+ < td style ="text-align: left; "> opaque object</ td >
42264241< td style ="text-align: left; "> optional</ td >
4227- < td style ="text-align: left; "> Timestamp of the frame </ td >
4242+ < td style ="text-align: left; "> Additional parameters for codec </ td >
42284243</ tr >
42294244< tr >
4230- < td style ="text-align: left; "> params.length </ td >
4245+ < td style ="text-align: left; "> params?.profile.channels </ td >
42314246< td style ="text-align: left; "> integer</ td >
42324247< td style ="text-align: left; "> mandatory</ td >
4233- < td style ="text-align: left; "> Size of the raw data frame in bytes </ td >
4248+ < td style ="text-align: left; "> Number of audio channels </ td >
42344249</ tr >
42354250< tr >
4236- < td style ="text-align: left; "> params.data </ td >
4237- < td style ="text-align: left; "> string (base64) </ td >
4251+ < td style ="text-align: left; "> params?.profile.resolution </ td >
4252+ < td style ="text-align: left; "> integer </ td >
42384253< td style ="text-align: left; "> mandatory</ td >
4239- < td style ="text-align: left; "> Raw audio data, the format of the data is specified in the most recent < em > audiotransmission</ em > notification</ td >
4254+ < td style ="text-align: left; "> Sample resultion in bits</ td >
4255+ </ tr >
4256+ < tr >
4257+ < td style ="text-align: left; "> params?.profile.samplerate</ td >
4258+ < td style ="text-align: left; "> integer</ td >
4259+ < td style ="text-align: left; "> mandatory</ td >
4260+ < td style ="text-align: left; "> Sample rate in hertz</ td >
4261+ </ tr >
4262+ < tr >
4263+ < td style ="text-align: left; "> params?.profile?.bitrate</ td >
4264+ < td style ="text-align: left; "> integer</ td >
4265+ < td style ="text-align: left; "> optional</ td >
4266+ < td style ="text-align: left; "> Data rate of the compressed stream in bits per second</ td >
42404267</ tr >
42414268</ tbody >
42424269</ table >
@@ -4247,32 +4274,34 @@ <h4 id="registration">Registration</h4>
42474274 "id": 42,
42484275 "method": "<callsign>.1.register",
42494276 "params": {
4250- "event": "audioframe ",
4277+ "event": "audiotransmission ",
42514278 "id": "myid"
42524279 }
42534280}
42544281</ code > </ pre >
42554282< h4 id ="notification "> Notification</ h4 >
42564283< pre > < code class ="language-json "> {
42574284 "jsonrpc": "2.0",
4258- "method": "myid.audioframe ",
4285+ "method": "myid.audiotransmission ",
42594286 "params": {
4260- "seq": 1,
4261- "timestamp": 0,
4262- "length": 400,
4263- "data": "..."
4287+ "state": "Idle",
4288+ "profile": {
4289+ "codec": "IMA-ADPCM",
4290+ "codecparams": {},
4291+ "channels": 1,
4292+ "resolution": 16,
4293+ "samplerate": 16000,
4294+ "bitrate": 64000
4295+ }
42644296 }
42654297}
42664298</ code > </ pre >
42674299< blockquote >
4268- < p > The < em > client ID</ em > parameter is passed within the notification designator, i.e. < code > <client-id>.audioframe</ code > .</ p >
4269- </ blockquote >
4270- < p > < a id ="notification_audiotransmission "> </ a > </ p >
4271- < h2 id ="audiotransmission-notification "> < em > audiotransmission < a href ="#head_Notifications "> < sup > notification</ sup > </ a > </ em > </ h2 >
4272- < p > Signals state of the stream.</ p >
4273- < blockquote >
4274- < p > This notification may also be triggered by client registration.</ p >
4300+ < p > The < em > client ID</ em > parameter is passed within the notification designator, i.e. < code > <client-id>.audiotransmission</ code > .</ p >
42754301</ blockquote >
4302+ < p > < a id ="notification_audioframe "> </ a > </ p >
4303+ < h2 id ="audioframe-notification "> < em > audioframe < a href ="#head_Notifications "> < sup > notification</ sup > </ a > </ em > </ h2 >
4304+ < p > Provides audio data.</ p >
42764305< h3 id ="notification-parameters_1 "> Notification Parameters</ h3 >
42774306< table >
42784307< thead >
@@ -4291,52 +4320,28 @@ <h3 id="notification-parameters_1">Notification Parameters</h3>
42914320< td style ="text-align: left; "> < em > ...</ em > </ td >
42924321</ tr >
42934322< tr >
4294- < td style ="text-align: left; "> params.state</ td >
4295- < td style ="text-align: left; "> string</ td >
4296- < td style ="text-align: left; "> mandatory</ td >
4297- < td style ="text-align: left; "> New state of the stream (must be one of the following: < em > Idle, Started, Unavailable</ em > )</ td >
4298- </ tr >
4299- < tr >
4300- < td style ="text-align: left; "> params?.profile</ td >
4301- < td style ="text-align: left; "> object</ td >
4302- < td style ="text-align: left; "> optional</ td >
4303- < td style ="text-align: left; "> Details on the format used in the stream</ td >
4304- </ tr >
4305- < tr >
4306- < td style ="text-align: left; "> params?.profile.codec</ td >
4307- < td style ="text-align: left; "> string</ td >
4308- < td style ="text-align: left; "> mandatory</ td >
4309- < td style ="text-align: left; "> Compression method (PCM: uncompressed) (must be one of the following: < em > IMA-ADPCM, PCM</ em > )</ td >
4310- </ tr >
4311- < tr >
4312- < td style ="text-align: left; "> params?.profile?.codecparams</ td >
4313- < td style ="text-align: left; "> opaque object</ td >
4323+ < td style ="text-align: left; "> params?.seq</ td >
4324+ < td style ="text-align: left; "> integer</ td >
43144325< td style ="text-align: left; "> optional</ td >
4315- < td style ="text-align: left; "> Additional parameters for codec </ td >
4326+ < td style ="text-align: left; "> Frame number in current transmission </ td >
43164327</ tr >
43174328< tr >
4318- < td style ="text-align: left; "> params?.profile.channels </ td >
4329+ < td style ="text-align: left; "> params?.timestamp </ td >
43194330< td style ="text-align: left; "> integer</ td >
4320- < td style ="text-align: left; "> mandatory </ td >
4321- < td style ="text-align: left; "> Number of audio channels </ td >
4331+ < td style ="text-align: left; "> optional </ td >
4332+ < td style ="text-align: left; "> Timestamp of the frame </ td >
43224333</ tr >
43234334< tr >
4324- < td style ="text-align: left; "> params?.profile.resolution </ td >
4335+ < td style ="text-align: left; "> params.length </ td >
43254336< td style ="text-align: left; "> integer</ td >
43264337< td style ="text-align: left; "> mandatory</ td >
4327- < td style ="text-align: left; "> Sample resultion in bits </ td >
4338+ < td style ="text-align: left; "> Size of the raw data frame in bytes </ td >
43284339</ tr >
43294340< tr >
4330- < td style ="text-align: left; "> params?.profile.samplerate </ td >
4331- < td style ="text-align: left; "> integer </ td >
4341+ < td style ="text-align: left; "> params.data </ td >
4342+ < td style ="text-align: left; "> string (base64) </ td >
43324343< td style ="text-align: left; "> mandatory</ td >
4333- < td style ="text-align: left; "> Sample rate in hertz</ td >
4334- </ tr >
4335- < tr >
4336- < td style ="text-align: left; "> params?.profile?.bitrate</ td >
4337- < td style ="text-align: left; "> integer</ td >
4338- < td style ="text-align: left; "> optional</ td >
4339- < td style ="text-align: left; "> Data rate of the compressed stream in bits per second</ td >
4344+ < td style ="text-align: left; "> Raw audio data, the format of the data is specified in the most recent < em > audiotransmission</ em > notification</ td >
43404345</ tr >
43414346</ tbody >
43424347</ table >
@@ -4347,30 +4352,25 @@ <h4 id="registration_1">Registration</h4>
43474352 "id": 42,
43484353 "method": "<callsign>.1.register",
43494354 "params": {
4350- "event": "audiotransmission ",
4355+ "event": "audioframe ",
43514356 "id": "myid"
43524357 }
43534358}
43544359</ code > </ pre >
43554360< h4 id ="notification_1 "> Notification</ h4 >
43564361< pre > < code class ="language-json "> {
43574362 "jsonrpc": "2.0",
4358- "method": "myid.audiotransmission ",
4363+ "method": "myid.audioframe ",
43594364 "params": {
4360- "state": "Idle",
4361- "profile": {
4362- "codec": "IMA-ADPCM",
4363- "codecparams": {},
4364- "channels": 1,
4365- "resolution": 16,
4366- "samplerate": 16000,
4367- "bitrate": 64000
4368- }
4365+ "seq": 1,
4366+ "timestamp": 0,
4367+ "length": 400,
4368+ "data": "..."
43694369 }
43704370}
43714371</ code > </ pre >
43724372< blockquote >
4373- < p > The < em > client ID</ em > parameter is passed within the notification designator, i.e. < code > <client-id>.audiotransmission </ code > .</ p >
4373+ < p > The < em > client ID</ em > parameter is passed within the notification designator, i.e. < code > <client-id>.audioframe </ code > .</ p >
43744374</ blockquote >
43754375
43764376
0 commit comments