NPAPI:AudioControl - Revision history

Josh: Update date

2015-06-24T23:33:57Z

Update date

← Older revision		Revision as of 23:33, 24 June 2015
Line 5:		Line 5:
	= Contributors =		= Contributors =

	* Last modified: June 1, 2015		* Last modified: June 24, 2015
	* Authors: Kyle Huey (Mozilla), Benoit Girard (Mozilla)		* Authors: Kyle Huey (Mozilla), Benoit Girard (Mozilla)
	* Contributors: Josh Aas (Mozilla)		* Contributors: Josh Aas (Mozilla)

Josh: General updates and bool is in pointer value, not pointed to

2015-06-24T23:32:50Z

General updates and bool is in pointer value, not pointed to

← Older revision		Revision as of 23:32, 24 June 2015
Line 1:		Line 1:
	= Status =		= Status =

	~~Drafting.~~		Approved

	= Contributors =		= Contributors =
Line 7:		Line 7:
	* Last modified: June 1, 2015		* Last modified: June 1, 2015
	* Authors: Kyle Huey (Mozilla), Benoit Girard (Mozilla)		* Authors: Kyle Huey (Mozilla), Benoit Girard (Mozilla)
	* Contributors:		* Contributors: Josh Aas (Mozilla)

	~~= Changes =~~

	~~Modified in 2015 to be a push API instead of a pull API and to use Get/SetValue.~~

	= Use case =		= Use case =
Line 24:		Line 20:
	</pre>		</pre>

	This NPPVariable, when set via NPN_SetValue, will ~~let the plugin~~ instance ~~signal via~~ a pointer to a BOOL ~~if the current instance is currently playing audio~~.		This NPPVariable, when set via NPN_SetValue, will signal whether or not an instance is currently playing audio. This is done by assigning a BOOL value to NPN_SetValue's pointer value argument (not by pointing to a BOOL, as one might expect).

	== Mute/Unmute a plugin instance ==		== Mute/Unmute a plugin instance ==
Line 32:		Line 28:
	</pre>		</pre>

	This NPNVariable, when set via NPP_SetValue, will ~~let the browser notify the~~ plugin ~~that~~ it should mute audio for ~~the current plugin~~ instance. ~~The~~ value ~~will be a~~ pointer to a BOOL.		This NPNVariable, when set via NPP_SetValue, will indicate to a plugin whether or not it should mute audio for an instance. This is done by assigning a BOOL value to NPP_SetValue's pointer value argument (not by pointing to a BOOL, as one might expect).

Bgirard: Clarify the value is a pointer to a bool

2015-06-10T17:15:15Z

Clarify the value is a pointer to a bool

← Older revision		Revision as of 17:15, 10 June 2015
Line 24:		Line 24:
	</pre>		</pre>

	This NPPVariable, when set via NPN_SetValue, will let the plugin instance signal via a BOOL if the current instance is currently playing audio.		This NPPVariable, when set via NPN_SetValue, will let the plugin instance signal via a pointer to a BOOL if the current instance is currently playing audio.

	== Mute/Unmute a plugin instance ==		== Mute/Unmute a plugin instance ==
Line 32:		Line 32:
	</pre>		</pre>

	This NPNVariable, when set via NPP_SetValue, will let the browser notify the plugin that it should mute audio for the current plugin instance.		This NPNVariable, when set via NPP_SetValue, will let the browser notify the plugin that it should mute audio for the current plugin instance. The value will be a pointer to a BOOL.

Bgirard: On the mailing list I suggested that if this is needed it can be proposed at a later time

2015-06-10T15:50:17Z

On the mailing list I suggested that if this is needed it can be proposed at a later time

← Older revision		Revision as of 15:50, 10 June 2015
Line 33:		Line 33:

	This NPNVariable, when set via NPP_SetValue, will let the browser notify the plugin that it should mute audio for the current plugin instance.		This NPNVariable, when set via NPP_SetValue, will let the browser notify the plugin that it should mute audio for the current plugin instance.

	~~= Open issues =~~
	* Will we want to be able to control the volume level on a per instance basis? This seems unnecessarily complicated.

Bgirard: typo

2015-06-01T23:51:09Z

typo

← Older revision		Revision as of 23:51, 1 June 2015
Line 11:		Line 11:
	= Changes =		= Changes =

	Modified in 2015 to be push API instead of a pull API and to use Get/SetValue.		Modified in 2015 to be a push API instead of a pull API and to use Get/SetValue.

	= Use case =		= Use case =

Bgirard: Modify to reflect the flash beta push API implementation

2015-06-01T23:20:03Z

Modify to reflect the flash beta push API implementation

← Older revision		Revision as of 23:20, 1 June 2015
Line 5:		Line 5:
	= Contributors =		= Contributors =

	* Last modified: ~~August 14~~, ~~2011~~		* Last modified: June 1, 2015
	* Authors: Kyle Huey (Mozilla)		* Authors: Kyle Huey (Mozilla), Benoit Girard (Mozilla)
	* Contributors:		* Contributors:

			= Changes =

			Modified in 2015 to be push API instead of a pull API and to use Get/SetValue.

	= Use case =		= Use case =
Line 17:		Line 21:

	<pre>		<pre>
	~~NPBool NPP_IsInstancePlayingAudio(NPP instance);~~		NPPVpluginIsPlayingAudio = 4000
	</pre>		</pre>

	This ~~function returns TRUE if~~ the plugin instance 'instance' is currently playing audio and FALSE if the plugin instance 'instance' is not. This function may only be called when at least one instance of a plugin has been created and not destroyed and 'instance' must be a live plugin instance when called.		This NPPVariable, when set via NPN_SetValue, will let the plugin instance signal via a BOOL if the current instance is currently playing audio.

	== Mute/Unmute a plugin instance ==		== Mute/Unmute a plugin instance ==

	<pre>		<pre>
	~~NPError NPP_MuteInstance(NPP instance);~~		NPNVmuteAudioBool = 4000
	~~NPError NPP_UnmuteInstance(NPP instance);~~
	</pre>		</pre>

	~~These functions~~ mute ~~or unmute (respectively)~~ the plugin instance ~~'instance'. These functions may only be called when at least one instance of a plugin has been created and not destroyed and 'instance' must be a live plugin instance when called~~.		This NPNVariable, when set via NPP_SetValue, will let the browser notify the plugin that it should mute audio for the current plugin instance.

	= Open issues =		= Open issues =
	* Should we condense NPP_[Mute\|Unmute]Instance into a single function taking a boolean mute/unmute argument?
	* Will we want to be able to control the volume level on a per instance basis? This seems unnecessarily complicated.		* Will we want to be able to control the volume level on a per instance basis? This seems unnecessarily complicated.

Khuey: /* Open issues */

2011-08-14T15:48:30Z

Open issues

← Older revision		Revision as of 15:48, 14 August 2011
Line 33:		Line 33:
	= Open issues =		= Open issues =
	* Should we condense NPP_[Mute\|Unmute]Instance into a single function taking a boolean mute/unmute argument?		* Should we condense NPP_[Mute\|Unmute]Instance into a single function taking a boolean mute/unmute argument?
	* Will we want to be able to control the volume level on a per instance basis?		* Will we want to be able to control the volume level on a per instance basis? This seems unnecessarily complicated.

Khuey: Created page with "= Status = Drafting. = Contributors = * Last modified: August 14, 2011 * Authors: Kyle Huey (Mozilla) * Contributors: = Use case = The ability to mute/unmute tabs or determ..."

2011-08-14T15:44:29Z

Created page with "= Status = Drafting. = Contributors = * Last modified: August 14, 2011 * Authors: Kyle Huey (Mozilla) * Contributors: = Use case = The ability to mute/unmute tabs or determ..."

New page

= Status =

Drafting.

= Contributors =

* Last modified: August 14, 2011
* Authors: Kyle Huey (Mozilla)
* Contributors:

= Use case =

The ability to mute/unmute tabs or determine which tabs are playing audio is a commonly requested feature in web browsers. This specification allows browsers to mute/unmute instances of cooperating plugins and determine which instances are playing audio. Browsers can use these APIs to implement per-tab audio control.

= Proposed Specification =
== Determine if an instance is playing audio ==

<pre>
NPBool NPP_IsInstancePlayingAudio(NPP instance);
</pre>

This function returns TRUE if the plugin instance 'instance' is currently playing audio and FALSE if the plugin instance 'instance' is not. This function may only be called when at least one instance of a plugin has been created and not destroyed and 'instance' must be a live plugin instance when called.

== Mute/Unmute a plugin instance ==

<pre>
NPError NPP_MuteInstance(NPP instance);
NPError NPP_UnmuteInstance(NPP instance);
</pre>

These functions mute or unmute (respectively) the plugin instance 'instance'. These functions may only be called when at least one instance of a plugin has been created and not destroyed and 'instance' must be a live plugin instance when called.

= Open issues =
* Should we condense NPP_[Mute|Unmute]Instance into a single function taking a boolean mute/unmute argument?
* Will we want to be able to control the volume level on a per instance basis?