v1

latestOpenAPI 3.1.02026-07-246652306.5 KB

playerVolume

setVolume

Use the setVolume command to set the player's volume and mute state.

Returns an empty body with a success value of true if successful. The player generates a playerVolume event if the volume was changed. Additionally, if setVolume is called on a player that has a fixed player volume state that is true, the command will fail and you will receive an ERROR_COMMAND_FAILED globalError. This is because players with fixed volumes cannot be changed, for example, a CONNECT with fixed line out would respond with this error if your app tried to set the volume on it.

post/players/{playerId}/playerVolume

Request body

volumeinteger nullable

(Optional) Between 0 and 100. Values above this range will be rejected. Any negative value will be interpreted as setting the volume level to 0.

mutedboolean nullable

(Optional) True to mute the player or false to unmute the player. If not specified, the existing mute state is maintained.

Response

See the x-muse-error-codes extension for a list of muse errors that generate this response

Ok required

This object represents an empty (default) success. The platform returns an empty object ({}).