package Torello.Browser;

import java.util.*;
import javax.json.*;
import javax.json.stream.*;
import java.io.*;

import java.lang.reflect.Method;
import java.lang.reflect.Parameter;
import java.util.function.Function;

import Torello.Java.Additional.*;
import Torello.Java.JSON.*;

import static Torello.Java.JSON.JFlag.*;

import Torello.Java.StrCmpr;
import Torello.JavaDoc.StaticFunctional;
import Torello.JavaDoc.JDHeaderBackgroundImg;
import Torello.JavaDoc.Excuse;

/**
 * <SPAN CLASS=COPIEDJDK><B>This domain allows detailed inspection of media elements</B></SPAN>
 * 
 * <EMBED CLASS='external-html' DATA-FILE-ID=CODE_GEN_NOTE>
 */
@StaticFunctional(Excused={"counter"}, Excuses={Excuse.CONFIGURATION})
@JDHeaderBackgroundImg(EmbedTagFileID="WOOD_PLANK_NOTE")
public class Media
{
    // ********************************************************************************************
    // ********************************************************************************************
    // Class Header Stuff
    // ********************************************************************************************
    // ********************************************************************************************


    // No Pubic Constructors
    private Media () { }

    // These two Vector's are used by all the "Methods" exported by this class.  java.lang.reflect
    // is used to generate the JSON String's.  It saves thousands of lines of Auto-Generated Code.
    private static final Map<String, Vector<String>>    parameterNames = new HashMap<>();
    private static final Map<String, Vector<Class<?>>>  parameterTypes = new HashMap<>();

    // Some Methods do not take any parameters - for instance all the "enable()" and "disable()"
    // I simply could not get ride of RAW-TYPES and UNCHECKED warnings... so there are now,
    // offically, two empty-vectors.  One for String's, and the other for Classes.

    private static final Vector<String>     EMPTY_VEC_STR = new Vector<>();
    private static final Vector<Class<?>>   EMPTY_VEC_CLASS = new Vector<>();

    static
    {
        for (Method m : Media.class.getMethods())
        {
            // This doesn't work!  The parameter names are all "arg0" ... "argN"
            // It works for java.lang.reflect.Field, BUT NOT java.lang.reflect.Parameter!
            //
            // Vector<String> parameterNamesList = new Vector<>(); -- NOPE!

            Vector<Class<?>> parameterTypesList = new Vector<>();
        
            for (Parameter p : m.getParameters()) parameterTypesList.add(p.getType());

            parameterTypes.put(
                m.getName(),
                (parameterTypesList.size() > 0) ? parameterTypesList : EMPTY_VEC_CLASS
            );
        }
    }

    static
    {
        Vector<String> v = null;

        parameterNames.put("enable", EMPTY_VEC_STR);

        parameterNames.put("disable", EMPTY_VEC_STR);
    }


    // ********************************************************************************************
    // ********************************************************************************************
    // Types - Static Inner Classes
    // ********************************************************************************************
    // ********************************************************************************************

    // public static class PlayerId => String
    
    // public static class Timestamp => Number
    
    /**
     * Have one type per entry in MediaLogRecord::Type
     * Corresponds to kMessage
     */
    public static class PlayerMessage
        extends BaseType
        implements java.io.Serializable
    {
        /** For Object Serialization.  java.io.Serializable */
        protected static final long serialVersionUID = 1;
        
        public boolean[] optionals()
        { return new boolean[] { false, false, }; }
        
        /**
         * Keep in sync with MediaLogMessageLevel
         * We are currently keeping the message level 'error' separate from the
         * PlayerError type because right now they represent different things,
         * this one being a DVLOG(ERROR) style log message that gets printed
         * based on what log level is selected in the UI, and the other is a
         * representation of a media::PipelineStatus object. Soon however we're
         * going to be moving away from using PipelineStatus for errors and
         * introducing a new error type which should hopefully let us integrate
         * the error log level into the PlayerError type.
         */
        public final String level;
        
        /** <CODE>[No Description Provided by Google]</CODE> */
        public final String message;
        
        /**
         * Constructor
         *
         * @param level 
         * Keep in sync with MediaLogMessageLevel
         * We are currently keeping the message level 'error' separate from the
         * PlayerError type because right now they represent different things,
         * this one being a DVLOG(ERROR) style log message that gets printed
         * based on what log level is selected in the UI, and the other is a
         * representation of a media::PipelineStatus object. Soon however we're
         * going to be moving away from using PipelineStatus for errors and
         * introducing a new error type which should hopefully let us integrate
         * the error log level into the PlayerError type.
         * <BR />Acceptable Values: ["error", "warning", "info", "debug"]
         * 
         * @param message -
         */
        public PlayerMessage(String level, String message)
        {
            // Exception-Check(s) to ensure that if any parameters which are not declared as
            // 'Optional', but have a 'null' value anyway, that a NullPointerException shall throw.
            
            if (level == null)   BRDPC.throwNPE("level");
            if (message == null) BRDPC.throwNPE("message");
            
            // Exception-Check(s) to ensure that if any parameters which must adhere to a
            // provided List of Enumerated Values, fails, then IllegalArgumentException shall throw.
            
            BRDPC.checkIAE(
                "level", level,
                "error", "warning", "info", "debug"
            );
            
            this.level    = level;
            this.message  = message;
        }
        
        /**
         * JSON Object Constructor
         * @param jo A Json-Object having data about an instance of {@code 'PlayerMessage'}.
         */
        public PlayerMessage (JsonObject jo)
        {
            this.level    = ReadJSON.getString(jo, "level", false, true);
            this.message  = ReadJSON.getString(jo, "message", false, true);
        }
        
        
        /** Checks whether {@code 'this'} equals an input Java-{@code Object} */
        public boolean equals(Object other)
        {
            if (other == null)                       return false;
            if (other.getClass() != this.getClass()) return false;
        
            PlayerMessage o = (PlayerMessage) other;
        
            return
                    Objects.equals(this.level, o.level)
                &&  Objects.equals(this.message, o.message);
        }
        
        /** Generates a Hash-Code for {@code 'this'} instance */
        public int hashCode()
        {
            return
                    Objects.hashCode(this.level)
                +   Objects.hashCode(this.message);
        }
    }
    
    /** Corresponds to kMediaPropertyChange */
    public static class PlayerProperty
        extends BaseType
        implements java.io.Serializable
    {
        /** For Object Serialization.  java.io.Serializable */
        protected static final long serialVersionUID = 1;
        
        public boolean[] optionals()
        { return new boolean[] { false, false, }; }
        
        /** <CODE>[No Description Provided by Google]</CODE> */
        public final String name;
        
        /** <CODE>[No Description Provided by Google]</CODE> */
        public final String value;
        
        /**
         * Constructor
         *
         * @param name -
         * 
         * @param value -
         */
        public PlayerProperty(String name, String value)
        {
            // Exception-Check(s) to ensure that if any parameters which are not declared as
            // 'Optional', but have a 'null' value anyway, that a NullPointerException shall throw.
            
            if (name == null)  BRDPC.throwNPE("name");
            if (value == null) BRDPC.throwNPE("value");
            
            this.name   = name;
            this.value  = value;
        }
        
        /**
         * JSON Object Constructor
         * @param jo A Json-Object having data about an instance of {@code 'PlayerProperty'}.
         */
        public PlayerProperty (JsonObject jo)
        {
            this.name   = ReadJSON.getString(jo, "name", false, true);
            this.value  = ReadJSON.getString(jo, "value", false, true);
        }
        
        
        /** Checks whether {@code 'this'} equals an input Java-{@code Object} */
        public boolean equals(Object other)
        {
            if (other == null)                       return false;
            if (other.getClass() != this.getClass()) return false;
        
            PlayerProperty o = (PlayerProperty) other;
        
            return
                    Objects.equals(this.name, o.name)
                &&  Objects.equals(this.value, o.value);
        }
        
        /** Generates a Hash-Code for {@code 'this'} instance */
        public int hashCode()
        {
            return
                    Objects.hashCode(this.name)
                +   Objects.hashCode(this.value);
        }
    }
    
    /** Corresponds to kMediaEventTriggered */
    public static class PlayerEvent
        extends BaseType
        implements java.io.Serializable
    {
        /** For Object Serialization.  java.io.Serializable */
        protected static final long serialVersionUID = 1;
        
        public boolean[] optionals()
        { return new boolean[] { false, false, }; }
        
        /** <CODE>[No Description Provided by Google]</CODE> */
        public final Number timestamp;
        
        /** <CODE>[No Description Provided by Google]</CODE> */
        public final String value;
        
        /**
         * Constructor
         *
         * @param timestamp -
         * 
         * @param value -
         */
        public PlayerEvent(Number timestamp, String value)
        {
            // Exception-Check(s) to ensure that if any parameters which are not declared as
            // 'Optional', but have a 'null' value anyway, that a NullPointerException shall throw.
            
            if (timestamp == null) BRDPC.throwNPE("timestamp");
            if (value == null)     BRDPC.throwNPE("value");
            
            this.timestamp  = timestamp;
            this.value      = value;
        }
        
        /**
         * JSON Object Constructor
         * @param jo A Json-Object having data about an instance of {@code 'PlayerEvent'}.
         */
        public PlayerEvent (JsonObject jo)
        {
            this.timestamp  = ReadNumberJSON.get(jo, "timestamp", false, true);
            this.value      = ReadJSON.getString(jo, "value", false, true);
        }
        
        
        /** Checks whether {@code 'this'} equals an input Java-{@code Object} */
        public boolean equals(Object other)
        {
            if (other == null)                       return false;
            if (other.getClass() != this.getClass()) return false;
        
            PlayerEvent o = (PlayerEvent) other;
        
            return
                    Objects.equals(this.timestamp, o.timestamp)
                &&  Objects.equals(this.value, o.value);
        }
        
        /** Generates a Hash-Code for {@code 'this'} instance */
        public int hashCode()
        {
            return
                    Objects.hashCode(this.timestamp)
                +   Objects.hashCode(this.value);
        }
    }
    
    /** Corresponds to kMediaError */
    public static class PlayerError
        extends BaseType
        implements java.io.Serializable
    {
        /** For Object Serialization.  java.io.Serializable */
        protected static final long serialVersionUID = 1;
        
        public boolean[] optionals()
        { return new boolean[] { false, false, }; }
        
        /** <CODE>[No Description Provided by Google]</CODE> */
        public final String type;
        
        /**
         * When this switches to using media::Status instead of PipelineStatus
         * we can remove "errorCode" and replace it with the fields from
         * a Status instance. This also seems like a duplicate of the error
         * level enum - there is a todo bug to have that level removed and
         * use this instead. (crbug.com/1068454)
         */
        public final String errorCode;
        
        /**
         * Constructor
         *
         * @param type -
         * <BR />Acceptable Values: ["pipeline_error", "media_error"]
         * 
         * @param errorCode 
         * When this switches to using media::Status instead of PipelineStatus
         * we can remove "errorCode" and replace it with the fields from
         * a Status instance. This also seems like a duplicate of the error
         * level enum - there is a todo bug to have that level removed and
         * use this instead. (crbug.com/1068454)
         */
        public PlayerError(String type, String errorCode)
        {
            // Exception-Check(s) to ensure that if any parameters which are not declared as
            // 'Optional', but have a 'null' value anyway, that a NullPointerException shall throw.
            
            if (type == null)      BRDPC.throwNPE("type");
            if (errorCode == null) BRDPC.throwNPE("errorCode");
            
            // Exception-Check(s) to ensure that if any parameters which must adhere to a
            // provided List of Enumerated Values, fails, then IllegalArgumentException shall throw.
            
            BRDPC.checkIAE(
                "type", type,
                "pipeline_error", "media_error"
            );
            
            this.type       = type;
            this.errorCode  = errorCode;
        }
        
        /**
         * JSON Object Constructor
         * @param jo A Json-Object having data about an instance of {@code 'PlayerError'}.
         */
        public PlayerError (JsonObject jo)
        {
            this.type       = ReadJSON.getString(jo, "type", false, true);
            this.errorCode  = ReadJSON.getString(jo, "errorCode", false, true);
        }
        
        
        /** Checks whether {@code 'this'} equals an input Java-{@code Object} */
        public boolean equals(Object other)
        {
            if (other == null)                       return false;
            if (other.getClass() != this.getClass()) return false;
        
            PlayerError o = (PlayerError) other;
        
            return
                    Objects.equals(this.type, o.type)
                &&  Objects.equals(this.errorCode, o.errorCode);
        }
        
        /** Generates a Hash-Code for {@code 'this'} instance */
        public int hashCode()
        {
            return
                    Objects.hashCode(this.type)
                +   Objects.hashCode(this.errorCode);
        }
    }
    
    /**
     * This can be called multiple times, and can be used to set / override /
     * remove player properties. A null propValue indicates removal.
     */
    public static class playerPropertiesChanged
        extends BrowserEvent
        implements java.io.Serializable
    {
        /** For Object Serialization.  java.io.Serializable */
        protected static final long serialVersionUID = 1;
        
        public boolean[] optionals()
        { return new boolean[] { false, false, }; }
        
        /** <CODE>[No Description Provided by Google]</CODE> */
        public final String playerId;
        
        /** <CODE>[No Description Provided by Google]</CODE> */
        public final Media.PlayerProperty[] properties;
        
        /**
         * Constructor
         *
         * @param playerId -
         * 
         * @param properties -
         */
        public playerPropertiesChanged(String playerId, Media.PlayerProperty[] properties)
        {
            super("Media", "playerPropertiesChanged", 2);
            
            // Exception-Check(s) to ensure that if any parameters which are not declared as
            // 'Optional', but have a 'null' value anyway, that a NullPointerException shall throw.
            
            if (playerId == null)   BRDPC.throwNPE("playerId");
            if (properties == null) BRDPC.throwNPE("properties");
            
            this.playerId    = playerId;
            this.properties  = properties;
        }
        
        /**
         * JSON Object Constructor
         * @param jo A Json-Object having data about an instance of {@code 'playerPropertiesChanged'}.
         */
        public playerPropertiesChanged (JsonObject jo)
        {
            super("Media", "playerPropertiesChanged", 2);
        
            this.playerId    = ReadJSON.getString(jo, "playerId", false, true);
            this.properties = (jo.getJsonArray("properties") == null)
                ? null
                : RJArrDimN.objArr(jo.getJsonArray("properties"), null, 0, Media.PlayerProperty[].class);
        
        }
        
        
        /** Checks whether {@code 'this'} equals an input Java-{@code Object} */
        public boolean equals(Object other)
        {
            if (other == null)                       return false;
            if (other.getClass() != this.getClass()) return false;
        
            playerPropertiesChanged o = (playerPropertiesChanged) other;
        
            return
                    Objects.equals(this.playerId, o.playerId)
                &&  Arrays.deepEquals(this.properties, o.properties);
        }
        
        /** Generates a Hash-Code for {@code 'this'} instance */
        public int hashCode()
        {
            return
                    Objects.hashCode(this.playerId)
                +   Arrays.deepHashCode(this.properties);
        }
    }
    
    /**
     * Send events as a list, allowing them to be batched on the browser for less
     * congestion. If batched, events must ALWAYS be in chronological order.
     */
    public static class playerEventsAdded
        extends BrowserEvent
        implements java.io.Serializable
    {
        /** For Object Serialization.  java.io.Serializable */
        protected static final long serialVersionUID = 1;
        
        public boolean[] optionals()
        { return new boolean[] { false, false, }; }
        
        /** <CODE>[No Description Provided by Google]</CODE> */
        public final String playerId;
        
        /** <CODE>[No Description Provided by Google]</CODE> */
        public final Media.PlayerEvent[] events;
        
        /**
         * Constructor
         *
         * @param playerId -
         * 
         * @param events -
         */
        public playerEventsAdded(String playerId, Media.PlayerEvent[] events)
        {
            super("Media", "playerEventsAdded", 2);
            
            // Exception-Check(s) to ensure that if any parameters which are not declared as
            // 'Optional', but have a 'null' value anyway, that a NullPointerException shall throw.
            
            if (playerId == null) BRDPC.throwNPE("playerId");
            if (events == null)   BRDPC.throwNPE("events");
            
            this.playerId  = playerId;
            this.events    = events;
        }
        
        /**
         * JSON Object Constructor
         * @param jo A Json-Object having data about an instance of {@code 'playerEventsAdded'}.
         */
        public playerEventsAdded (JsonObject jo)
        {
            super("Media", "playerEventsAdded", 2);
        
            this.playerId  = ReadJSON.getString(jo, "playerId", false, true);
            this.events = (jo.getJsonArray("events") == null)
                ? null
                : RJArrDimN.objArr(jo.getJsonArray("events"), null, 0, Media.PlayerEvent[].class);
        
        }
        
        
        /** Checks whether {@code 'this'} equals an input Java-{@code Object} */
        public boolean equals(Object other)
        {
            if (other == null)                       return false;
            if (other.getClass() != this.getClass()) return false;
        
            playerEventsAdded o = (playerEventsAdded) other;
        
            return
                    Objects.equals(this.playerId, o.playerId)
                &&  Arrays.deepEquals(this.events, o.events);
        }
        
        /** Generates a Hash-Code for {@code 'this'} instance */
        public int hashCode()
        {
            return
                    Objects.hashCode(this.playerId)
                +   Arrays.deepHashCode(this.events);
        }
    }
    
    /** Send a list of any messages that need to be delivered. */
    public static class playerMessagesLogged
        extends BrowserEvent
        implements java.io.Serializable
    {
        /** For Object Serialization.  java.io.Serializable */
        protected static final long serialVersionUID = 1;
        
        public boolean[] optionals()
        { return new boolean[] { false, false, }; }
        
        /** <CODE>[No Description Provided by Google]</CODE> */
        public final String playerId;
        
        /** <CODE>[No Description Provided by Google]</CODE> */
        public final Media.PlayerMessage[] messages;
        
        /**
         * Constructor
         *
         * @param playerId -
         * 
         * @param messages -
         */
        public playerMessagesLogged(String playerId, Media.PlayerMessage[] messages)
        {
            super("Media", "playerMessagesLogged", 2);
            
            // Exception-Check(s) to ensure that if any parameters which are not declared as
            // 'Optional', but have a 'null' value anyway, that a NullPointerException shall throw.
            
            if (playerId == null) BRDPC.throwNPE("playerId");
            if (messages == null) BRDPC.throwNPE("messages");
            
            this.playerId  = playerId;
            this.messages  = messages;
        }
        
        /**
         * JSON Object Constructor
         * @param jo A Json-Object having data about an instance of {@code 'playerMessagesLogged'}.
         */
        public playerMessagesLogged (JsonObject jo)
        {
            super("Media", "playerMessagesLogged", 2);
        
            this.playerId  = ReadJSON.getString(jo, "playerId", false, true);
            this.messages = (jo.getJsonArray("messages") == null)
                ? null
                : RJArrDimN.objArr(jo.getJsonArray("messages"), null, 0, Media.PlayerMessage[].class);
        
        }
        
        
        /** Checks whether {@code 'this'} equals an input Java-{@code Object} */
        public boolean equals(Object other)
        {
            if (other == null)                       return false;
            if (other.getClass() != this.getClass()) return false;
        
            playerMessagesLogged o = (playerMessagesLogged) other;
        
            return
                    Objects.equals(this.playerId, o.playerId)
                &&  Arrays.deepEquals(this.messages, o.messages);
        }
        
        /** Generates a Hash-Code for {@code 'this'} instance */
        public int hashCode()
        {
            return
                    Objects.hashCode(this.playerId)
                +   Arrays.deepHashCode(this.messages);
        }
    }
    
    /** Send a list of any errors that need to be delivered. */
    public static class playerErrorsRaised
        extends BrowserEvent
        implements java.io.Serializable
    {
        /** For Object Serialization.  java.io.Serializable */
        protected static final long serialVersionUID = 1;
        
        public boolean[] optionals()
        { return new boolean[] { false, false, }; }
        
        /** <CODE>[No Description Provided by Google]</CODE> */
        public final String playerId;
        
        /** <CODE>[No Description Provided by Google]</CODE> */
        public final Media.PlayerError[] errors;
        
        /**
         * Constructor
         *
         * @param playerId -
         * 
         * @param errors -
         */
        public playerErrorsRaised(String playerId, Media.PlayerError[] errors)
        {
            super("Media", "playerErrorsRaised", 2);
            
            // Exception-Check(s) to ensure that if any parameters which are not declared as
            // 'Optional', but have a 'null' value anyway, that a NullPointerException shall throw.
            
            if (playerId == null) BRDPC.throwNPE("playerId");
            if (errors == null)   BRDPC.throwNPE("errors");
            
            this.playerId  = playerId;
            this.errors    = errors;
        }
        
        /**
         * JSON Object Constructor
         * @param jo A Json-Object having data about an instance of {@code 'playerErrorsRaised'}.
         */
        public playerErrorsRaised (JsonObject jo)
        {
            super("Media", "playerErrorsRaised", 2);
        
            this.playerId  = ReadJSON.getString(jo, "playerId", false, true);
            this.errors = (jo.getJsonArray("errors") == null)
                ? null
                : RJArrDimN.objArr(jo.getJsonArray("errors"), null, 0, Media.PlayerError[].class);
        
        }
        
        
        /** Checks whether {@code 'this'} equals an input Java-{@code Object} */
        public boolean equals(Object other)
        {
            if (other == null)                       return false;
            if (other.getClass() != this.getClass()) return false;
        
            playerErrorsRaised o = (playerErrorsRaised) other;
        
            return
                    Objects.equals(this.playerId, o.playerId)
                &&  Arrays.deepEquals(this.errors, o.errors);
        }
        
        /** Generates a Hash-Code for {@code 'this'} instance */
        public int hashCode()
        {
            return
                    Objects.hashCode(this.playerId)
                +   Arrays.deepHashCode(this.errors);
        }
    }
    
    /**
     * Called whenever a player is created, or when a new agent joins and receives
     * a list of active players. If an agent is restored, it will receive the full
     * list of player ids and all events again.
     */
    public static class playersCreated
        extends BrowserEvent
        implements java.io.Serializable
    {
        /** For Object Serialization.  java.io.Serializable */
        protected static final long serialVersionUID = 1;
        
        public boolean[] optionals()
        { return new boolean[] { false, }; }
        
        /** <CODE>[No Description Provided by Google]</CODE> */
        public final String[] players;
        
        /**
         * Constructor
         *
         * @param players -
         */
        public playersCreated(String[] players)
        {
            super("Media", "playersCreated", 1);
            
            // Exception-Check(s) to ensure that if any parameters which are not declared as
            // 'Optional', but have a 'null' value anyway, that a NullPointerException shall throw.
            
            if (players == null) BRDPC.throwNPE("players");
            
            this.players  = players;
        }
        
        /**
         * JSON Object Constructor
         * @param jo A Json-Object having data about an instance of {@code 'playersCreated'}.
         */
        public playersCreated (JsonObject jo)
        {
            super("Media", "playersCreated", 1);
        
            this.players = (jo.getJsonArray("players") == null)
                ? null
                : RJArrIntoStream.strArr(jo.getJsonArray("players"), null, 0).toArray(String[]::new);
        
        }
        
        
        /** Checks whether {@code 'this'} equals an input Java-{@code Object} */
        public boolean equals(Object other)
        {
            if (other == null)                       return false;
            if (other.getClass() != this.getClass()) return false;
        
            playersCreated o = (playersCreated) other;
        
            return
                    Arrays.deepEquals(this.players, o.players);
        }
        
        /** Generates a Hash-Code for {@code 'this'} instance */
        public int hashCode()
        {
            return
                    Arrays.deepHashCode(this.players);
        }
    }
    
    
    // Counter for keeping the WebSocket Request ID's distinct.
    private static int counter = 1;
    
    /**
     * Enables the Media domain
     * 
     * @return An instance of <CODE>{@link Script}&lt;String, {@link JsonObject},
     * {@link Ret0}&gt;</CODE>
     *
     * <BR /><BR />This {@code Script} instance must be <B STYLE='color:red'>executed</B> before the
     * browser receives the invocation-request.
     *
     * <BR /><BR />This Browser-Function <I>does not have</I> a return-value.  You may choose to
     * <B STYLE='color: red'>await</B> the {@link Promise}{@code <JsonObject,} {@link Ret0}
     * {@code >} to ensure the Browser Function has run to completion.
     */
    public static Script<String, JsonObject, Ret0> enable()
    {
        final int          webSocketID = 45000000 + counter++;
        final boolean[]    optionals   = new boolean[0];
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("enable"),
            parameterNames.get("enable"),
            optionals, webSocketID,
            "Media.enable"
        );
        
        // This Remote Command does not have a Return-Value.
        return new Script<>
            (BRDPC.defaultSender, webSocketID, requestJSON, BRDPC.NoReturnValues);
    }
    
    /**
     * Disables the Media domain.
     * 
     * @return An instance of <CODE>{@link Script}&lt;String, {@link JsonObject},
     * {@link Ret0}&gt;</CODE>
     *
     * <BR /><BR />This {@code Script} instance must be <B STYLE='color:red'>executed</B> before the
     * browser receives the invocation-request.
     *
     * <BR /><BR />This Browser-Function <I>does not have</I> a return-value.  You may choose to
     * <B STYLE='color: red'>await</B> the {@link Promise}{@code <JsonObject,} {@link Ret0}
     * {@code >} to ensure the Browser Function has run to completion.
     */
    public static Script<String, JsonObject, Ret0> disable()
    {
        final int          webSocketID = 45001000 + counter++;
        final boolean[]    optionals   = new boolean[0];
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("disable"),
            parameterNames.get("disable"),
            optionals, webSocketID,
            "Media.disable"
        );
        
        // This Remote Command does not have a Return-Value.
        return new Script<>
            (BRDPC.defaultSender, webSocketID, requestJSON, BRDPC.NoReturnValues);
    }
    
}