001package Torello.Browser.BrowserAPI;
002
003// *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** ***
004// Java-HTML Imports
005// *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** ***
006
007import Torello.Browser.*;
008import Torello.Browser.helper.*;
009import Torello.Browser.JavaScriptAPI.*;
010import Torello.JSON.*;
011
012import Torello.Java.ReadOnly.ReadOnlyList;
013import Torello.Java.ReadOnly.ReadOnlyArrayList;
014
015import Torello.JavaDoc.Annotations.StaticFunctional;
016import Torello.JavaDoc.Annotations.JDHeaderBackgroundImg;
017
018import Torello.Browser.BrowserAPI.NestedHelpers.Commands.WebAudio$$Commands;
019
020
021// *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** ***
022// JDK Imports
023// *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** ***
024
025import javax.json.JsonObject;
026import javax.json.JsonValue;
027
028/**
029 * <SPAN CLASS=COPIEDJDK><B>This domain allows inspection of Web Audio API.
030 * https://webaudio.github.io/web-audio-api/</B></SPAN>
031 * <EMBED CLASS='external-html' DATA-FILE-ID=CDP.CODE_GEN_NOTE>
032 */
033@StaticFunctional@JDHeaderBackgroundImg(EmbedTagFileID="CDP.WOOD_PLANK_NOTE")
034public class WebAudio
035{
036    // No Pubic Constructors
037    private WebAudio() { }
038
039
040    // ********************************************************************************************
041    // ********************************************************************************************
042    // Eliminated Types
043    // ********************************************************************************************
044    // ********************************************************************************************
045
046
047    /**
048     * An unique ID for a graph object (AudioContext, AudioNode, AudioParam) in Web Audio API
049
050     * <EMBED CLASS='external-html' DATA-CTAS='String' DATA-FILE-ID=CDP.EliminatedType
051     *     DATA-NAME=GraphObjectId>
052     */
053    public static final String GraphObjectId =
054        "GraphObjectId has been eliminated.\n" +
055        "It was replaced with the standard Java-Type: String";
056
057    /**
058     * Enum of AudioNode types
059
060     * <EMBED CLASS='external-html' DATA-CTAS='String' DATA-FILE-ID=CDP.EliminatedType
061     *     DATA-NAME=NodeType>
062     */
063    public static final String NodeType =
064        "NodeType has been eliminated.\n" +
065        "It was replaced with the standard Java-Type: String";
066
067    /**
068     * Enum of AudioParam types
069
070     * <EMBED CLASS='external-html' DATA-CTAS='String' DATA-FILE-ID=CDP.EliminatedType
071     *     DATA-NAME=ParamType>
072     */
073    public static final String ParamType =
074        "ParamType has been eliminated.\n" +
075        "It was replaced with the standard Java-Type: String";
076
077
078    // ********************************************************************************************
079    // ********************************************************************************************
080    // Enumerated String Constants Lists
081    // ********************************************************************************************
082    // ********************************************************************************************
083
084
085    /**
086     * Enum of AudioParam::AutomationRate from the spec
087     * <BR /><BR /><B CLASS=StrEnumType>String-Enumeration Type</B>
088     */
089    public static final ReadOnlyList<String> AutomationRate = new ReadOnlyArrayList<>
090        (String.class, "a-rate", "k-rate");
091
092    /**
093     * Enum of AudioNode::ChannelCountMode from the spec
094     * <BR /><BR /><B CLASS=StrEnumType>String-Enumeration Type</B>
095     */
096    public static final ReadOnlyList<String> ChannelCountMode = new ReadOnlyArrayList<>
097        (String.class, "clamped-max", "explicit", "max");
098
099    /**
100     * Enum of AudioNode::ChannelInterpretation from the spec
101     * <BR /><BR /><B CLASS=StrEnumType>String-Enumeration Type</B>
102     */
103    public static final ReadOnlyList<String> ChannelInterpretation = new ReadOnlyArrayList<>
104        (String.class, "discrete", "speakers");
105
106    /**
107     * Enum of AudioContextState from the spec
108     * <BR /><BR /><B CLASS=StrEnumType>String-Enumeration Type</B>
109     */
110    public static final ReadOnlyList<String> ContextState = new ReadOnlyArrayList<>
111        (String.class, "closed", "interrupted", "running", "suspended");
112
113    /**
114     * Enum of BaseAudioContext types
115     * <BR /><BR /><B CLASS=StrEnumType>String-Enumeration Type</B>
116     */
117    public static final ReadOnlyList<String> ContextType = new ReadOnlyArrayList<>
118        (String.class, "offline", "realtime");
119
120
121
122    // ********************************************************************************************
123    // ********************************************************************************************
124    // Basic Types
125    // ********************************************************************************************
126    // ********************************************************************************************
127
128
129    /**
130     * Protocol object for AudioListener
131     * 
132     * <EMBED CLASS=globalDefs DATA-DOMAIN=WebAudio DATA-API=BrowserAPI>
133     */
134    @JDHeaderBackgroundImg(EmbedTagFileID="CDP.NESTED_TYPE_JDHBI")
135    public static class AudioListener
136        extends BaseType<AudioListener>
137        implements java.io.Serializable
138    {
139        /** <EMBED CLASS='external-html' DATA-FILE-ID=SVUID> */
140        protected static final long serialVersionUID = 1;
141
142        private static final NestedHelper<WebAudio.AudioListener> singleton =
143            Torello.Browser.BrowserAPI.NestedHelpers.Types.
144                WebAudio$$AudioListener$$.singleton;
145
146        /** <CODE>[No Description Provided by Google]</CODE> */
147        public final String listenerId;
148
149        /** <CODE>[No Description Provided by Google]</CODE> */
150        public final String contextId;
151
152        /** Constructor.  Please review this class' fields for documentation. */
153        public AudioListener(ReadOnlyList<Boolean> isPresent, String listenerId, String contextId)
154        {
155            super(singleton, Domains.WebAudio, "AudioListener", 2);
156
157            this.listenerId = listenerId;
158            this.contextId  = contextId;
159
160            this.isPresent = (isPresent == null)
161                ? singleton.generateIsPresentList(this)
162                : THROWS.check(isPresent, 2, "WebAudio.AudioListener");
163        }
164
165        /** Creates an instance of this class from a {@link JsonObject}.*/
166        public static AudioListener fromJSON(JsonObject jo)
167        { return singleton.fromJSON(jo); }
168
169        /** Returns this class's {@link NestedDescriptor} singleton-instance. class / type.*/
170        public static NestedDescriptor<AudioListener> descriptor()
171        { return singleton.descriptor(); }
172    }
173
174    /**
175     * Protocol object for AudioNode
176     * 
177     * <EMBED CLASS=globalDefs DATA-DOMAIN=WebAudio DATA-API=BrowserAPI>
178     */
179    @JDHeaderBackgroundImg(EmbedTagFileID="CDP.NESTED_TYPE_JDHBI")
180    public static class AudioNode
181        extends BaseType<AudioNode>
182        implements java.io.Serializable
183    {
184        /** <EMBED CLASS='external-html' DATA-FILE-ID=SVUID> */
185        protected static final long serialVersionUID = 1;
186
187        private static final NestedHelper<WebAudio.AudioNode> singleton =
188            Torello.Browser.BrowserAPI.NestedHelpers.Types.
189                WebAudio$$AudioNode$$.singleton;
190
191        /** <CODE>[No Description Provided by Google]</CODE> */
192        public final String nodeId;
193
194        /** <CODE>[No Description Provided by Google]</CODE> */
195        public final String contextId;
196
197        /** <CODE>[No Description Provided by Google]</CODE> */
198        public final String nodeType;
199
200        /** <CODE>[No Description Provided by Google]</CODE> */
201        public final Number numberOfInputs;
202
203        /** <CODE>[No Description Provided by Google]</CODE> */
204        public final Number numberOfOutputs;
205
206        /** <CODE>[No Description Provided by Google]</CODE> */
207        public final Number channelCount;
208
209        /**
210         * <CODE>[No Description Provided by Google]</CODE>
211         * <EMBED CLASS='external-html' DATA-D=WebAudio DATA-C=ChannelCountMode DATA-F=channelCountMode DATA-FILE-ID=CDP.EL2>
212         * @see BaseType#enumStrList(String)
213         */
214        public final String channelCountMode;
215
216        /**
217         * <CODE>[No Description Provided by Google]</CODE>
218         * <EMBED CLASS='external-html' DATA-D=WebAudio DATA-C=ChannelInterpretation DATA-F=channelInterpretation DATA-FILE-ID=CDP.EL2>
219         * @see BaseType#enumStrList(String)
220         */
221        public final String channelInterpretation;
222
223        /** Constructor.  Please review this class' fields for documentation. */
224        public AudioNode(
225                ReadOnlyList<Boolean> isPresent, String nodeId, String contextId, String nodeType,
226                Number numberOfInputs, Number numberOfOutputs, Number channelCount,
227                String channelCountMode, String channelInterpretation
228            )
229        {
230            super(singleton, Domains.WebAudio, "AudioNode", 8);
231
232            this.nodeId                 = nodeId;
233            this.contextId              = contextId;
234            this.nodeType               = nodeType;
235            this.numberOfInputs         = numberOfInputs;
236            this.numberOfOutputs        = numberOfOutputs;
237            this.channelCount           = channelCount;
238            this.channelCountMode       = channelCountMode;
239            this.channelInterpretation  = channelInterpretation;
240
241            this.isPresent = (isPresent == null)
242                ? singleton.generateIsPresentList(this)
243                : THROWS.check(isPresent, 8, "WebAudio.AudioNode");
244        }
245
246        /** Creates an instance of this class from a {@link JsonObject}.*/
247        public static AudioNode fromJSON(JsonObject jo)
248        { return singleton.fromJSON(jo); }
249
250        /** Returns this class's {@link NestedDescriptor} singleton-instance. class / type.*/
251        public static NestedDescriptor<AudioNode> descriptor()
252        { return singleton.descriptor(); }
253    }
254
255    /**
256     * Protocol object for AudioParam
257     * 
258     * <EMBED CLASS=globalDefs DATA-DOMAIN=WebAudio DATA-API=BrowserAPI>
259     */
260    @JDHeaderBackgroundImg(EmbedTagFileID="CDP.NESTED_TYPE_JDHBI")
261    public static class AudioParam
262        extends BaseType<AudioParam>
263        implements java.io.Serializable
264    {
265        /** <EMBED CLASS='external-html' DATA-FILE-ID=SVUID> */
266        protected static final long serialVersionUID = 1;
267
268        private static final NestedHelper<WebAudio.AudioParam> singleton =
269            Torello.Browser.BrowserAPI.NestedHelpers.Types.
270                WebAudio$$AudioParam$$.singleton;
271
272        /** <CODE>[No Description Provided by Google]</CODE> */
273        public final String paramId;
274
275        /** <CODE>[No Description Provided by Google]</CODE> */
276        public final String nodeId;
277
278        /** <CODE>[No Description Provided by Google]</CODE> */
279        public final String contextId;
280
281        /** <CODE>[No Description Provided by Google]</CODE> */
282        public final String paramType;
283
284        /**
285         * <CODE>[No Description Provided by Google]</CODE>
286         * <EMBED CLASS='external-html' DATA-D=WebAudio DATA-C=AutomationRate DATA-F=rate DATA-FILE-ID=CDP.EL2>
287         * @see BaseType#enumStrList(String)
288         */
289        public final String rate;
290
291        /** <CODE>[No Description Provided by Google]</CODE> */
292        public final Number defaultValue;
293
294        /** <CODE>[No Description Provided by Google]</CODE> */
295        public final Number minValue;
296
297        /** <CODE>[No Description Provided by Google]</CODE> */
298        public final Number maxValue;
299
300        /** Constructor.  Please review this class' fields for documentation. */
301        public AudioParam(
302                ReadOnlyList<Boolean> isPresent, String paramId, String nodeId, String contextId,
303                String paramType, String rate, Number defaultValue, Number minValue,
304                Number maxValue
305            )
306        {
307            super(singleton, Domains.WebAudio, "AudioParam", 8);
308
309            this.paramId        = paramId;
310            this.nodeId         = nodeId;
311            this.contextId      = contextId;
312            this.paramType      = paramType;
313            this.rate           = rate;
314            this.defaultValue   = defaultValue;
315            this.minValue       = minValue;
316            this.maxValue       = maxValue;
317
318            this.isPresent = (isPresent == null)
319                ? singleton.generateIsPresentList(this)
320                : THROWS.check(isPresent, 8, "WebAudio.AudioParam");
321        }
322
323        /** Creates an instance of this class from a {@link JsonObject}.*/
324        public static AudioParam fromJSON(JsonObject jo)
325        { return singleton.fromJSON(jo); }
326
327        /** Returns this class's {@link NestedDescriptor} singleton-instance. class / type.*/
328        public static NestedDescriptor<AudioParam> descriptor()
329        { return singleton.descriptor(); }
330    }
331
332    /**
333     * Protocol object for BaseAudioContext
334     * 
335     * <EMBED CLASS=globalDefs DATA-DOMAIN=WebAudio DATA-API=BrowserAPI>
336     */
337    @JDHeaderBackgroundImg(EmbedTagFileID="CDP.NESTED_TYPE_JDHBI")
338    public static class BaseAudioContext
339        extends BaseType<BaseAudioContext>
340        implements java.io.Serializable
341    {
342        /** <EMBED CLASS='external-html' DATA-FILE-ID=SVUID> */
343        protected static final long serialVersionUID = 1;
344
345        private static final NestedHelper<WebAudio.BaseAudioContext> singleton =
346            Torello.Browser.BrowserAPI.NestedHelpers.Types.
347                WebAudio$$BaseAudioContext$$.singleton;
348
349        /** <CODE>[No Description Provided by Google]</CODE> */
350        public final String contextId;
351
352        /**
353         * <CODE>[No Description Provided by Google]</CODE>
354         * <EMBED CLASS='external-html' DATA-D=WebAudio DATA-C=ContextType DATA-F=contextType DATA-FILE-ID=CDP.EL2>
355         * @see BaseType#enumStrList(String)
356         */
357        public final String contextType;
358
359        /**
360         * <CODE>[No Description Provided by Google]</CODE>
361         * <EMBED CLASS='external-html' DATA-D=WebAudio DATA-C=ContextState DATA-F=contextState DATA-FILE-ID=CDP.EL2>
362         * @see BaseType#enumStrList(String)
363         */
364        public final String contextState;
365
366        /**
367         * <CODE>[No Description Provided by Google]</CODE>
368         * <BR /><B CLASS=Opt-Top>OPTIONAL</B>
369         */
370        public final WebAudio.ContextRealtimeData realtimeData;
371
372        /** Platform-dependent callback buffer size. */
373        public final Number callbackBufferSize;
374
375        /** Number of output channels supported by audio hardware in use. */
376        public final Number maxOutputChannelCount;
377
378        /** Context sample rate. */
379        public final Number sampleRate;
380
381        /** Constructor.  Please review this class' fields for documentation. */
382        public BaseAudioContext(
383                ReadOnlyList<Boolean> isPresent, String contextId, String contextType,
384                String contextState, ContextRealtimeData realtimeData, Number callbackBufferSize,
385                Number maxOutputChannelCount, Number sampleRate
386            )
387        {
388            super(singleton, Domains.WebAudio, "BaseAudioContext", 7);
389
390            this.contextId              = contextId;
391            this.contextType            = contextType;
392            this.contextState           = contextState;
393            this.realtimeData           = realtimeData;
394            this.callbackBufferSize     = callbackBufferSize;
395            this.maxOutputChannelCount  = maxOutputChannelCount;
396            this.sampleRate             = sampleRate;
397
398            this.isPresent = (isPresent == null)
399                ? singleton.generateIsPresentList(this)
400                : THROWS.check(isPresent, 7, "WebAudio.BaseAudioContext");
401        }
402
403        /** Creates an instance of this class from a {@link JsonObject}.*/
404        public static BaseAudioContext fromJSON(JsonObject jo)
405        { return singleton.fromJSON(jo); }
406
407        /** Returns this class's {@link NestedDescriptor} singleton-instance. class / type.*/
408        public static NestedDescriptor<BaseAudioContext> descriptor()
409        { return singleton.descriptor(); }
410    }
411
412    /**
413     * Fields in AudioContext that change in real-time.
414     * 
415     * <EMBED CLASS=globalDefs DATA-DOMAIN=WebAudio DATA-API=BrowserAPI>
416     */
417    @JDHeaderBackgroundImg(EmbedTagFileID="CDP.NESTED_TYPE_JDHBI")
418    public static class ContextRealtimeData
419        extends BaseType<ContextRealtimeData>
420        implements java.io.Serializable
421    {
422        /** <EMBED CLASS='external-html' DATA-FILE-ID=SVUID> */
423        protected static final long serialVersionUID = 1;
424
425        private static final NestedHelper<WebAudio.ContextRealtimeData> singleton =
426            Torello.Browser.BrowserAPI.NestedHelpers.Types.
427                WebAudio$$ContextRealtimeData$$.singleton;
428
429        /** The current context time in second in BaseAudioContext. */
430        public final Number currentTime;
431
432        /**
433         * The time spent on rendering graph divided by render quantum duration,
434         * and multiplied by 100. 100 means the audio renderer reached the full
435         * capacity and glitch may occur.
436         */
437        public final Number renderCapacity;
438
439        /** A running mean of callback interval. */
440        public final Number callbackIntervalMean;
441
442        /** A running variance of callback interval. */
443        public final Number callbackIntervalVariance;
444
445        /** Constructor.  Please review this class' fields for documentation. */
446        public ContextRealtimeData(
447                ReadOnlyList<Boolean> isPresent, Number currentTime, Number renderCapacity,
448                Number callbackIntervalMean, Number callbackIntervalVariance
449            )
450        {
451            super(singleton, Domains.WebAudio, "ContextRealtimeData", 4);
452
453            this.currentTime                = currentTime;
454            this.renderCapacity             = renderCapacity;
455            this.callbackIntervalMean       = callbackIntervalMean;
456            this.callbackIntervalVariance   = callbackIntervalVariance;
457
458            this.isPresent = (isPresent == null)
459                ? singleton.generateIsPresentList(this)
460                : THROWS.check(isPresent, 4, "WebAudio.ContextRealtimeData");
461        }
462
463        /** Creates an instance of this class from a {@link JsonObject}.*/
464        public static ContextRealtimeData fromJSON(JsonObject jo)
465        { return singleton.fromJSON(jo); }
466
467        /** Returns this class's {@link NestedDescriptor} singleton-instance. class / type.*/
468        public static NestedDescriptor<ContextRealtimeData> descriptor()
469        { return singleton.descriptor(); }
470    }
471
472
473    // ********************************************************************************************
474    // ********************************************************************************************
475    // Event Types
476    // ********************************************************************************************
477    // ********************************************************************************************
478
479
480    /**
481     * Notifies that the construction of an AudioListener has finished.
482     * 
483     * <EMBED CLASS=globalDefs DATA-DOMAIN=WebAudio DATA-API=BrowserAPI>
484     */
485    @JDHeaderBackgroundImg(EmbedTagFileID="CDP.NESTED_EVENT_JDHBI")
486    public static class audioListenerCreated
487        extends BrowserEvent<audioListenerCreated>
488        implements java.io.Serializable
489    {
490        /** <EMBED CLASS='external-html' DATA-FILE-ID=SVUID> */
491        protected static final long serialVersionUID = 1;
492
493        private static final NestedHelper<WebAudio.audioListenerCreated> singleton =
494            Torello.Browser.BrowserAPI.NestedHelpers.Events.
495                WebAudio$$audioListenerCreated$$.singleton;
496
497        /** <CODE>[No Description Provided by Google]</CODE> */
498        public final WebAudio.AudioListener listener;
499
500        /** Constructor.  Please review this class' fields for documentation. */
501        public audioListenerCreated(ReadOnlyList<Boolean> isPresent, AudioListener listener)
502        {
503            super(singleton, Domains.WebAudio, "audioListenerCreated", 1);
504
505            this.listener = listener;
506
507            this.isPresent = (isPresent == null)
508                ? singleton.generateIsPresentList(this)
509                : THROWS.check(isPresent, 1, "WebAudio.audioListenerCreated");
510        }
511
512        /** Creates an instance of this class from a {@link JsonObject}.*/
513        public static audioListenerCreated fromJSON(JsonObject jo)
514        { return singleton.fromJSON(jo); }
515
516        /** Returns this class's {@link NestedDescriptor} singleton-instance. class / type.*/
517        public static NestedDescriptor<audioListenerCreated> descriptor()
518        { return singleton.descriptor(); }
519    }
520
521    /**
522     * Notifies that a new AudioListener has been created.
523     * 
524     * <EMBED CLASS=globalDefs DATA-DOMAIN=WebAudio DATA-API=BrowserAPI>
525     */
526    @JDHeaderBackgroundImg(EmbedTagFileID="CDP.NESTED_EVENT_JDHBI")
527    public static class audioListenerWillBeDestroyed
528        extends BrowserEvent<audioListenerWillBeDestroyed>
529        implements java.io.Serializable
530    {
531        /** <EMBED CLASS='external-html' DATA-FILE-ID=SVUID> */
532        protected static final long serialVersionUID = 1;
533
534        private static final NestedHelper<WebAudio.audioListenerWillBeDestroyed> singleton =
535            Torello.Browser.BrowserAPI.NestedHelpers.Events.
536                WebAudio$$audioListenerWillBeDestroyed$$.singleton;
537
538        /** <CODE>[No Description Provided by Google]</CODE> */
539        public final String contextId;
540
541        /** <CODE>[No Description Provided by Google]</CODE> */
542        public final String listenerId;
543
544        /** Constructor.  Please review this class' fields for documentation. */
545        public audioListenerWillBeDestroyed
546            (ReadOnlyList<Boolean> isPresent, String contextId, String listenerId)
547        {
548            super(singleton, Domains.WebAudio, "audioListenerWillBeDestroyed", 2);
549
550            this.contextId  = contextId;
551            this.listenerId = listenerId;
552
553            this.isPresent = (isPresent == null)
554                ? singleton.generateIsPresentList(this)
555                : THROWS.check(isPresent, 2, "WebAudio.audioListenerWillBeDestroyed");
556        }
557
558        /** Creates an instance of this class from a {@link JsonObject}.*/
559        public static audioListenerWillBeDestroyed fromJSON(JsonObject jo)
560        { return singleton.fromJSON(jo); }
561
562        /** Returns this class's {@link NestedDescriptor} singleton-instance. class / type.*/
563        public static NestedDescriptor<audioListenerWillBeDestroyed> descriptor()
564        { return singleton.descriptor(); }
565    }
566
567    /**
568     * Notifies that a new AudioNode has been created.
569     * 
570     * <EMBED CLASS=globalDefs DATA-DOMAIN=WebAudio DATA-API=BrowserAPI>
571     */
572    @JDHeaderBackgroundImg(EmbedTagFileID="CDP.NESTED_EVENT_JDHBI")
573    public static class audioNodeCreated
574        extends BrowserEvent<audioNodeCreated>
575        implements java.io.Serializable
576    {
577        /** <EMBED CLASS='external-html' DATA-FILE-ID=SVUID> */
578        protected static final long serialVersionUID = 1;
579
580        private static final NestedHelper<WebAudio.audioNodeCreated> singleton =
581            Torello.Browser.BrowserAPI.NestedHelpers.Events.
582                WebAudio$$audioNodeCreated$$.singleton;
583
584        /** <CODE>[No Description Provided by Google]</CODE> */
585        public final WebAudio.AudioNode node;
586
587        /** Constructor.  Please review this class' fields for documentation. */
588        public audioNodeCreated(ReadOnlyList<Boolean> isPresent, AudioNode node)
589        {
590            super(singleton, Domains.WebAudio, "audioNodeCreated", 1);
591
592            this.node = node;
593
594            this.isPresent = (isPresent == null)
595                ? singleton.generateIsPresentList(this)
596                : THROWS.check(isPresent, 1, "WebAudio.audioNodeCreated");
597        }
598
599        /** Creates an instance of this class from a {@link JsonObject}.*/
600        public static audioNodeCreated fromJSON(JsonObject jo)
601        { return singleton.fromJSON(jo); }
602
603        /** Returns this class's {@link NestedDescriptor} singleton-instance. class / type.*/
604        public static NestedDescriptor<audioNodeCreated> descriptor()
605        { return singleton.descriptor(); }
606    }
607
608    /**
609     * Notifies that an existing AudioNode has been destroyed.
610     * 
611     * <EMBED CLASS=globalDefs DATA-DOMAIN=WebAudio DATA-API=BrowserAPI>
612     */
613    @JDHeaderBackgroundImg(EmbedTagFileID="CDP.NESTED_EVENT_JDHBI")
614    public static class audioNodeWillBeDestroyed
615        extends BrowserEvent<audioNodeWillBeDestroyed>
616        implements java.io.Serializable
617    {
618        /** <EMBED CLASS='external-html' DATA-FILE-ID=SVUID> */
619        protected static final long serialVersionUID = 1;
620
621        private static final NestedHelper<WebAudio.audioNodeWillBeDestroyed> singleton =
622            Torello.Browser.BrowserAPI.NestedHelpers.Events.
623                WebAudio$$audioNodeWillBeDestroyed$$.singleton;
624
625        /** <CODE>[No Description Provided by Google]</CODE> */
626        public final String contextId;
627
628        /** <CODE>[No Description Provided by Google]</CODE> */
629        public final String nodeId;
630
631        /** Constructor.  Please review this class' fields for documentation. */
632        public audioNodeWillBeDestroyed
633            (ReadOnlyList<Boolean> isPresent, String contextId, String nodeId)
634        {
635            super(singleton, Domains.WebAudio, "audioNodeWillBeDestroyed", 2);
636
637            this.contextId  = contextId;
638            this.nodeId     = nodeId;
639
640            this.isPresent = (isPresent == null)
641                ? singleton.generateIsPresentList(this)
642                : THROWS.check(isPresent, 2, "WebAudio.audioNodeWillBeDestroyed");
643        }
644
645        /** Creates an instance of this class from a {@link JsonObject}.*/
646        public static audioNodeWillBeDestroyed fromJSON(JsonObject jo)
647        { return singleton.fromJSON(jo); }
648
649        /** Returns this class's {@link NestedDescriptor} singleton-instance. class / type.*/
650        public static NestedDescriptor<audioNodeWillBeDestroyed> descriptor()
651        { return singleton.descriptor(); }
652    }
653
654    /**
655     * Notifies that a new AudioParam has been created.
656     * 
657     * <EMBED CLASS=globalDefs DATA-DOMAIN=WebAudio DATA-API=BrowserAPI>
658     */
659    @JDHeaderBackgroundImg(EmbedTagFileID="CDP.NESTED_EVENT_JDHBI")
660    public static class audioParamCreated
661        extends BrowserEvent<audioParamCreated>
662        implements java.io.Serializable
663    {
664        /** <EMBED CLASS='external-html' DATA-FILE-ID=SVUID> */
665        protected static final long serialVersionUID = 1;
666
667        private static final NestedHelper<WebAudio.audioParamCreated> singleton =
668            Torello.Browser.BrowserAPI.NestedHelpers.Events.
669                WebAudio$$audioParamCreated$$.singleton;
670
671        /** <CODE>[No Description Provided by Google]</CODE> */
672        public final WebAudio.AudioParam param;
673
674        /** Constructor.  Please review this class' fields for documentation. */
675        public audioParamCreated(ReadOnlyList<Boolean> isPresent, AudioParam param)
676        {
677            super(singleton, Domains.WebAudio, "audioParamCreated", 1);
678
679            this.param = param;
680
681            this.isPresent = (isPresent == null)
682                ? singleton.generateIsPresentList(this)
683                : THROWS.check(isPresent, 1, "WebAudio.audioParamCreated");
684        }
685
686        /** Creates an instance of this class from a {@link JsonObject}.*/
687        public static audioParamCreated fromJSON(JsonObject jo)
688        { return singleton.fromJSON(jo); }
689
690        /** Returns this class's {@link NestedDescriptor} singleton-instance. class / type.*/
691        public static NestedDescriptor<audioParamCreated> descriptor()
692        { return singleton.descriptor(); }
693    }
694
695    /**
696     * Notifies that an existing AudioParam has been destroyed.
697     * 
698     * <EMBED CLASS=globalDefs DATA-DOMAIN=WebAudio DATA-API=BrowserAPI>
699     */
700    @JDHeaderBackgroundImg(EmbedTagFileID="CDP.NESTED_EVENT_JDHBI")
701    public static class audioParamWillBeDestroyed
702        extends BrowserEvent<audioParamWillBeDestroyed>
703        implements java.io.Serializable
704    {
705        /** <EMBED CLASS='external-html' DATA-FILE-ID=SVUID> */
706        protected static final long serialVersionUID = 1;
707
708        private static final NestedHelper<WebAudio.audioParamWillBeDestroyed> singleton =
709            Torello.Browser.BrowserAPI.NestedHelpers.Events.
710                WebAudio$$audioParamWillBeDestroyed$$.singleton;
711
712        /** <CODE>[No Description Provided by Google]</CODE> */
713        public final String contextId;
714
715        /** <CODE>[No Description Provided by Google]</CODE> */
716        public final String nodeId;
717
718        /** <CODE>[No Description Provided by Google]</CODE> */
719        public final String paramId;
720
721        /** Constructor.  Please review this class' fields for documentation. */
722        public audioParamWillBeDestroyed
723            (ReadOnlyList<Boolean> isPresent, String contextId, String nodeId, String paramId)
724        {
725            super(singleton, Domains.WebAudio, "audioParamWillBeDestroyed", 3);
726
727            this.contextId  = contextId;
728            this.nodeId     = nodeId;
729            this.paramId    = paramId;
730
731            this.isPresent = (isPresent == null)
732                ? singleton.generateIsPresentList(this)
733                : THROWS.check(isPresent, 3, "WebAudio.audioParamWillBeDestroyed");
734        }
735
736        /** Creates an instance of this class from a {@link JsonObject}.*/
737        public static audioParamWillBeDestroyed fromJSON(JsonObject jo)
738        { return singleton.fromJSON(jo); }
739
740        /** Returns this class's {@link NestedDescriptor} singleton-instance. class / type.*/
741        public static NestedDescriptor<audioParamWillBeDestroyed> descriptor()
742        { return singleton.descriptor(); }
743    }
744
745    /**
746     * Notifies that existing BaseAudioContext has changed some properties (id stays the same)..
747     * 
748     * <EMBED CLASS=globalDefs DATA-DOMAIN=WebAudio DATA-API=BrowserAPI>
749     */
750    @JDHeaderBackgroundImg(EmbedTagFileID="CDP.NESTED_EVENT_JDHBI")
751    public static class contextChanged
752        extends BrowserEvent<contextChanged>
753        implements java.io.Serializable
754    {
755        /** <EMBED CLASS='external-html' DATA-FILE-ID=SVUID> */
756        protected static final long serialVersionUID = 1;
757
758        private static final NestedHelper<WebAudio.contextChanged> singleton =
759            Torello.Browser.BrowserAPI.NestedHelpers.Events.
760                WebAudio$$contextChanged$$.singleton;
761
762        /** <CODE>[No Description Provided by Google]</CODE> */
763        public final WebAudio.BaseAudioContext context;
764
765        /** Constructor.  Please review this class' fields for documentation. */
766        public contextChanged(ReadOnlyList<Boolean> isPresent, BaseAudioContext context)
767        {
768            super(singleton, Domains.WebAudio, "contextChanged", 1);
769
770            this.context = context;
771
772            this.isPresent = (isPresent == null)
773                ? singleton.generateIsPresentList(this)
774                : THROWS.check(isPresent, 1, "WebAudio.contextChanged");
775        }
776
777        /** Creates an instance of this class from a {@link JsonObject}.*/
778        public static contextChanged fromJSON(JsonObject jo)
779        { return singleton.fromJSON(jo); }
780
781        /** Returns this class's {@link NestedDescriptor} singleton-instance. class / type.*/
782        public static NestedDescriptor<contextChanged> descriptor()
783        { return singleton.descriptor(); }
784    }
785
786    /**
787     * Notifies that a new BaseAudioContext has been created.
788     * 
789     * <EMBED CLASS=globalDefs DATA-DOMAIN=WebAudio DATA-API=BrowserAPI>
790     */
791    @JDHeaderBackgroundImg(EmbedTagFileID="CDP.NESTED_EVENT_JDHBI")
792    public static class contextCreated
793        extends BrowserEvent<contextCreated>
794        implements java.io.Serializable
795    {
796        /** <EMBED CLASS='external-html' DATA-FILE-ID=SVUID> */
797        protected static final long serialVersionUID = 1;
798
799        private static final NestedHelper<WebAudio.contextCreated> singleton =
800            Torello.Browser.BrowserAPI.NestedHelpers.Events.
801                WebAudio$$contextCreated$$.singleton;
802
803        /** <CODE>[No Description Provided by Google]</CODE> */
804        public final WebAudio.BaseAudioContext context;
805
806        /** Constructor.  Please review this class' fields for documentation. */
807        public contextCreated(ReadOnlyList<Boolean> isPresent, BaseAudioContext context)
808        {
809            super(singleton, Domains.WebAudio, "contextCreated", 1);
810
811            this.context = context;
812
813            this.isPresent = (isPresent == null)
814                ? singleton.generateIsPresentList(this)
815                : THROWS.check(isPresent, 1, "WebAudio.contextCreated");
816        }
817
818        /** Creates an instance of this class from a {@link JsonObject}.*/
819        public static contextCreated fromJSON(JsonObject jo)
820        { return singleton.fromJSON(jo); }
821
822        /** Returns this class's {@link NestedDescriptor} singleton-instance. class / type.*/
823        public static NestedDescriptor<contextCreated> descriptor()
824        { return singleton.descriptor(); }
825    }
826
827    /**
828     * Notifies that an existing BaseAudioContext will be destroyed.
829     * 
830     * <EMBED CLASS=globalDefs DATA-DOMAIN=WebAudio DATA-API=BrowserAPI>
831     */
832    @JDHeaderBackgroundImg(EmbedTagFileID="CDP.NESTED_EVENT_JDHBI")
833    public static class contextWillBeDestroyed
834        extends BrowserEvent<contextWillBeDestroyed>
835        implements java.io.Serializable
836    {
837        /** <EMBED CLASS='external-html' DATA-FILE-ID=SVUID> */
838        protected static final long serialVersionUID = 1;
839
840        private static final NestedHelper<WebAudio.contextWillBeDestroyed> singleton =
841            Torello.Browser.BrowserAPI.NestedHelpers.Events.
842                WebAudio$$contextWillBeDestroyed$$.singleton;
843
844        /** <CODE>[No Description Provided by Google]</CODE> */
845        public final String contextId;
846
847        /** Constructor.  Please review this class' fields for documentation. */
848        public contextWillBeDestroyed(ReadOnlyList<Boolean> isPresent, String contextId)
849        {
850            super(singleton, Domains.WebAudio, "contextWillBeDestroyed", 1);
851
852            this.contextId = contextId;
853
854            this.isPresent = (isPresent == null)
855                ? singleton.generateIsPresentList(this)
856                : THROWS.check(isPresent, 1, "WebAudio.contextWillBeDestroyed");
857        }
858
859        /** Creates an instance of this class from a {@link JsonObject}.*/
860        public static contextWillBeDestroyed fromJSON(JsonObject jo)
861        { return singleton.fromJSON(jo); }
862
863        /** Returns this class's {@link NestedDescriptor} singleton-instance. class / type.*/
864        public static NestedDescriptor<contextWillBeDestroyed> descriptor()
865        { return singleton.descriptor(); }
866    }
867
868    /**
869     * Notifies that an AudioNode is connected to an AudioParam.
870     * 
871     * <EMBED CLASS=globalDefs DATA-DOMAIN=WebAudio DATA-API=BrowserAPI>
872     */
873    @JDHeaderBackgroundImg(EmbedTagFileID="CDP.NESTED_EVENT_JDHBI")
874    public static class nodeParamConnected
875        extends BrowserEvent<nodeParamConnected>
876        implements java.io.Serializable
877    {
878        /** <EMBED CLASS='external-html' DATA-FILE-ID=SVUID> */
879        protected static final long serialVersionUID = 1;
880
881        private static final NestedHelper<WebAudio.nodeParamConnected> singleton =
882            Torello.Browser.BrowserAPI.NestedHelpers.Events.
883                WebAudio$$nodeParamConnected$$.singleton;
884
885        /** <CODE>[No Description Provided by Google]</CODE> */
886        public final String contextId;
887
888        /** <CODE>[No Description Provided by Google]</CODE> */
889        public final String sourceId;
890
891        /** <CODE>[No Description Provided by Google]</CODE> */
892        public final String destinationId;
893
894        /**
895         * <CODE>[No Description Provided by Google]</CODE>
896         * <BR /><B CLASS=Opt-Top>OPTIONAL</B>
897         */
898        public final Number sourceOutputIndex;
899
900        /** Constructor.  Please review this class' fields for documentation. */
901        public nodeParamConnected(
902                ReadOnlyList<Boolean> isPresent, String contextId, String sourceId,
903                String destinationId, Number sourceOutputIndex
904            )
905        {
906            super(singleton, Domains.WebAudio, "nodeParamConnected", 4);
907
908            this.contextId          = contextId;
909            this.sourceId           = sourceId;
910            this.destinationId      = destinationId;
911            this.sourceOutputIndex  = sourceOutputIndex;
912
913            this.isPresent = (isPresent == null)
914                ? singleton.generateIsPresentList(this)
915                : THROWS.check(isPresent, 4, "WebAudio.nodeParamConnected");
916        }
917
918        /** Creates an instance of this class from a {@link JsonObject}.*/
919        public static nodeParamConnected fromJSON(JsonObject jo)
920        { return singleton.fromJSON(jo); }
921
922        /** Returns this class's {@link NestedDescriptor} singleton-instance. class / type.*/
923        public static NestedDescriptor<nodeParamConnected> descriptor()
924        { return singleton.descriptor(); }
925    }
926
927    /**
928     * Notifies that an AudioNode is disconnected to an AudioParam.
929     * 
930     * <EMBED CLASS=globalDefs DATA-DOMAIN=WebAudio DATA-API=BrowserAPI>
931     */
932    @JDHeaderBackgroundImg(EmbedTagFileID="CDP.NESTED_EVENT_JDHBI")
933    public static class nodeParamDisconnected
934        extends BrowserEvent<nodeParamDisconnected>
935        implements java.io.Serializable
936    {
937        /** <EMBED CLASS='external-html' DATA-FILE-ID=SVUID> */
938        protected static final long serialVersionUID = 1;
939
940        private static final NestedHelper<WebAudio.nodeParamDisconnected> singleton =
941            Torello.Browser.BrowserAPI.NestedHelpers.Events.
942                WebAudio$$nodeParamDisconnected$$.singleton;
943
944        /** <CODE>[No Description Provided by Google]</CODE> */
945        public final String contextId;
946
947        /** <CODE>[No Description Provided by Google]</CODE> */
948        public final String sourceId;
949
950        /** <CODE>[No Description Provided by Google]</CODE> */
951        public final String destinationId;
952
953        /**
954         * <CODE>[No Description Provided by Google]</CODE>
955         * <BR /><B CLASS=Opt-Top>OPTIONAL</B>
956         */
957        public final Number sourceOutputIndex;
958
959        /** Constructor.  Please review this class' fields for documentation. */
960        public nodeParamDisconnected(
961                ReadOnlyList<Boolean> isPresent, String contextId, String sourceId,
962                String destinationId, Number sourceOutputIndex
963            )
964        {
965            super(singleton, Domains.WebAudio, "nodeParamDisconnected", 4);
966
967            this.contextId          = contextId;
968            this.sourceId           = sourceId;
969            this.destinationId      = destinationId;
970            this.sourceOutputIndex  = sourceOutputIndex;
971
972            this.isPresent = (isPresent == null)
973                ? singleton.generateIsPresentList(this)
974                : THROWS.check(isPresent, 4, "WebAudio.nodeParamDisconnected");
975        }
976
977        /** Creates an instance of this class from a {@link JsonObject}.*/
978        public static nodeParamDisconnected fromJSON(JsonObject jo)
979        { return singleton.fromJSON(jo); }
980
981        /** Returns this class's {@link NestedDescriptor} singleton-instance. class / type.*/
982        public static NestedDescriptor<nodeParamDisconnected> descriptor()
983        { return singleton.descriptor(); }
984    }
985
986    /**
987     * Notifies that two AudioNodes are connected.
988     * 
989     * <EMBED CLASS=globalDefs DATA-DOMAIN=WebAudio DATA-API=BrowserAPI>
990     */
991    @JDHeaderBackgroundImg(EmbedTagFileID="CDP.NESTED_EVENT_JDHBI")
992    public static class nodesConnected
993        extends BrowserEvent<nodesConnected>
994        implements java.io.Serializable
995    {
996        /** <EMBED CLASS='external-html' DATA-FILE-ID=SVUID> */
997        protected static final long serialVersionUID = 1;
998
999        private static final NestedHelper<WebAudio.nodesConnected> singleton =
1000            Torello.Browser.BrowserAPI.NestedHelpers.Events.
1001                WebAudio$$nodesConnected$$.singleton;
1002
1003        /** <CODE>[No Description Provided by Google]</CODE> */
1004        public final String contextId;
1005
1006        /** <CODE>[No Description Provided by Google]</CODE> */
1007        public final String sourceId;
1008
1009        /** <CODE>[No Description Provided by Google]</CODE> */
1010        public final String destinationId;
1011
1012        /**
1013         * <CODE>[No Description Provided by Google]</CODE>
1014         * <BR /><B CLASS=Opt-Top>OPTIONAL</B>
1015         */
1016        public final Number sourceOutputIndex;
1017
1018        /**
1019         * <CODE>[No Description Provided by Google]</CODE>
1020         * <BR /><B CLASS=Opt-Top>OPTIONAL</B>
1021         */
1022        public final Number destinationInputIndex;
1023
1024        /** Constructor.  Please review this class' fields for documentation. */
1025        public nodesConnected(
1026                ReadOnlyList<Boolean> isPresent, String contextId, String sourceId,
1027                String destinationId, Number sourceOutputIndex, Number destinationInputIndex
1028            )
1029        {
1030            super(singleton, Domains.WebAudio, "nodesConnected", 5);
1031
1032            this.contextId              = contextId;
1033            this.sourceId               = sourceId;
1034            this.destinationId          = destinationId;
1035            this.sourceOutputIndex      = sourceOutputIndex;
1036            this.destinationInputIndex  = destinationInputIndex;
1037
1038            this.isPresent = (isPresent == null)
1039                ? singleton.generateIsPresentList(this)
1040                : THROWS.check(isPresent, 5, "WebAudio.nodesConnected");
1041        }
1042
1043        /** Creates an instance of this class from a {@link JsonObject}.*/
1044        public static nodesConnected fromJSON(JsonObject jo)
1045        { return singleton.fromJSON(jo); }
1046
1047        /** Returns this class's {@link NestedDescriptor} singleton-instance. class / type.*/
1048        public static NestedDescriptor<nodesConnected> descriptor()
1049        { return singleton.descriptor(); }
1050    }
1051
1052    /**
1053     * Notifies that AudioNodes are disconnected. The destination can be null, and it means all the outgoing connections from the source are disconnected.
1054     * 
1055     * <EMBED CLASS=globalDefs DATA-DOMAIN=WebAudio DATA-API=BrowserAPI>
1056     */
1057    @JDHeaderBackgroundImg(EmbedTagFileID="CDP.NESTED_EVENT_JDHBI")
1058    public static class nodesDisconnected
1059        extends BrowserEvent<nodesDisconnected>
1060        implements java.io.Serializable
1061    {
1062        /** <EMBED CLASS='external-html' DATA-FILE-ID=SVUID> */
1063        protected static final long serialVersionUID = 1;
1064
1065        private static final NestedHelper<WebAudio.nodesDisconnected> singleton =
1066            Torello.Browser.BrowserAPI.NestedHelpers.Events.
1067                WebAudio$$nodesDisconnected$$.singleton;
1068
1069        /** <CODE>[No Description Provided by Google]</CODE> */
1070        public final String contextId;
1071
1072        /** <CODE>[No Description Provided by Google]</CODE> */
1073        public final String sourceId;
1074
1075        /** <CODE>[No Description Provided by Google]</CODE> */
1076        public final String destinationId;
1077
1078        /**
1079         * <CODE>[No Description Provided by Google]</CODE>
1080         * <BR /><B CLASS=Opt-Top>OPTIONAL</B>
1081         */
1082        public final Number sourceOutputIndex;
1083
1084        /**
1085         * <CODE>[No Description Provided by Google]</CODE>
1086         * <BR /><B CLASS=Opt-Top>OPTIONAL</B>
1087         */
1088        public final Number destinationInputIndex;
1089
1090        /** Constructor.  Please review this class' fields for documentation. */
1091        public nodesDisconnected(
1092                ReadOnlyList<Boolean> isPresent, String contextId, String sourceId,
1093                String destinationId, Number sourceOutputIndex, Number destinationInputIndex
1094            )
1095        {
1096            super(singleton, Domains.WebAudio, "nodesDisconnected", 5);
1097
1098            this.contextId              = contextId;
1099            this.sourceId               = sourceId;
1100            this.destinationId          = destinationId;
1101            this.sourceOutputIndex      = sourceOutputIndex;
1102            this.destinationInputIndex  = destinationInputIndex;
1103
1104            this.isPresent = (isPresent == null)
1105                ? singleton.generateIsPresentList(this)
1106                : THROWS.check(isPresent, 5, "WebAudio.nodesDisconnected");
1107        }
1108
1109        /** Creates an instance of this class from a {@link JsonObject}.*/
1110        public static nodesDisconnected fromJSON(JsonObject jo)
1111        { return singleton.fromJSON(jo); }
1112
1113        /** Returns this class's {@link NestedDescriptor} singleton-instance. class / type.*/
1114        public static NestedDescriptor<nodesDisconnected> descriptor()
1115        { return singleton.descriptor(); }
1116    }
1117
1118
1119
1120
1121    // ********************************************************************************************
1122    // ********************************************************************************************
1123    // Commands
1124    // ********************************************************************************************
1125    // ********************************************************************************************
1126
1127
1128    /**
1129     * Disables the WebAudio domain.
1130     * 
1131     * @return An instance of <CODE>{@link Script}&lt;Void&gt;</CODE>
1132     *
1133     * <BR /><BR />This {@code Script} instance must be <B STYLE='color:red'>executed</B> before the
1134     * browser receives the invocation-request.
1135     *
1136     * <BR /><BR /><DIV CLASS=JDHint>
1137     * This Browser-Function <I>does not have</I> a return-value.  You may choose to
1138     * <B STYLE='color: red'>await</B> the {@link Promise}{@code <Void>} to ensure that
1139     * the Browser Function has run to completion.
1140     * </DIV>
1141     */
1142    public static Script<Void> disable()
1143    {
1144        // Ultra-Simple Request JSON - Because this method has no parameters
1145        final String requestJSON = "{\"method\":\"WebAudio.disable\"}";
1146
1147        return Script.NO_RET(Domains.WebAudio, "disable", requestJSON);
1148    }
1149
1150    /**
1151     * Enables the WebAudio domain and starts sending context lifetime events.
1152     * 
1153     * @return An instance of <CODE>{@link Script}&lt;Void&gt;</CODE>
1154     *
1155     * <BR /><BR />This {@code Script} instance must be <B STYLE='color:red'>executed</B> before the
1156     * browser receives the invocation-request.
1157     *
1158     * <BR /><BR /><DIV CLASS=JDHint>
1159     * This Browser-Function <I>does not have</I> a return-value.  You may choose to
1160     * <B STYLE='color: red'>await</B> the {@link Promise}{@code <Void>} to ensure that
1161     * the Browser Function has run to completion.
1162     * </DIV>
1163     */
1164    public static Script<Void> enable()
1165    {
1166        // Ultra-Simple Request JSON - Because this method has no parameters
1167        final String requestJSON = "{\"method\":\"WebAudio.enable\"}";
1168
1169        return Script.NO_RET(Domains.WebAudio, "enable", requestJSON);
1170    }
1171
1172    /**
1173     * Fetch the realtime data from the registered contexts.
1174     * 
1175     * @param contextId -
1176     * 
1177     * @return An instance of <CODE>{@link Script}&lt;{@link WebAudio.ContextRealtimeData}&gt;</CODE>
1178     * 
1179     * <BR /><BR />This <B>script</B> may be <B STYLE='color: red'>executed</B>, using
1180     * {@link Script#exec(WebSocketSender) Script.exec}, and afterwards, a {@link Promise}
1181     * <CODE>&lt;{@link WebAudio.ContextRealtimeData}&gt;</CODE> will be returned
1182     *
1183     * <BR /><BR />Finally, the <B>{@code Promise}</B> may be <B STYLE='color: red'>awaited</B>,
1184     * using {@link Promise#await()}, <I>and the returned result of this Browser Function may
1185     * be retrieved.</I>
1186     *
1187     * <BR /><BR /><DIV CLASS=JDHint>
1188     * This Browser Function's {@code Promise} returns:
1189     * <CODE>{@link WebAudio.ContextRealtimeData} (<B>realtimeData</B>)</CODE>
1190     * </DIV>
1191     */
1192    public static Script<WebAudio.ContextRealtimeData> getRealtimeData(String contextId)
1193    {
1194        // Build the JSON Request-Object (as a String); only 1 Parameter is passed
1195        final String requestJSON = WriteJSON.get
1196            (CDPTypes.STRING, "contextId", false, "WebAudio.getRealtimeData", contextId);
1197
1198        return new Script<>(
1199            Domains.WebAudio, "getRealtimeData", requestJSON,
1200            WebAudio$$Commands::getRealtimeData,
1201            WebAudio.ContextRealtimeData.class
1202        );
1203    }
1204
1205
1206}