135 lines
4.5 KiB
Python
135 lines
4.5 KiB
Python
import voluptuous as vol
|
|
|
|
from homeassistant.components.media_player import MediaPlayerEntityFeature
|
|
from homeassistant.core import State
|
|
from homeassistant.helpers import config_validation as cv
|
|
from homeassistant.helpers.intent import (
|
|
Intent,
|
|
IntentResponse,
|
|
)
|
|
from homeassistant.const import (
|
|
STATE_PAUSED,
|
|
STATE_PLAYING,
|
|
)
|
|
|
|
from smartinspectpython.siauto import SILevel, SIColors
|
|
|
|
from ..appmessages import STAppMessages
|
|
from ..intent_loader import IntentLoader
|
|
from ..const import (
|
|
CONF_VALUE,
|
|
DOMAIN,
|
|
INTENT_PLAYER_SET_SHUFFLE_MODE,
|
|
PLATFORM_SPOTIFYPLUS,
|
|
RESPONSE_PLAYER_NOT_PLAYING_MEDIA,
|
|
SERVICE_SPOTIFY_PLAYER_SET_SHUFFLE_MODE,
|
|
SLOT_AREA,
|
|
SLOT_DELAY,
|
|
SLOT_FLOOR,
|
|
SLOT_NAME,
|
|
SLOT_PLAYER_SHUFFLE_MODE,
|
|
SLOT_PREFERRED_AREA_ID,
|
|
SLOT_PREFERRED_FLOOR_ID,
|
|
)
|
|
|
|
from .spotifyplusintenthandler import SpotifyPlusIntentHandler
|
|
|
|
|
|
class SpotifyPlusPlayerSetShuffleMode_Handler(SpotifyPlusIntentHandler):
|
|
"""
|
|
Handles intents for SpotifyPlusPlayerSetShuffleMode.
|
|
"""
|
|
def __init__(self, intentLoader:IntentLoader) -> None:
|
|
"""
|
|
Initializes a new instance of the IntentHandler class.
|
|
"""
|
|
# invoke base class method.
|
|
super().__init__(intentLoader)
|
|
|
|
# set intent handler basics.
|
|
self.description = "Set shuffle mode for the specified SpotifyPlus media player."
|
|
self.intent_type = INTENT_PLAYER_SET_SHUFFLE_MODE
|
|
self.platforms = {PLATFORM_SPOTIFYPLUS}
|
|
|
|
|
|
@property
|
|
def slot_schema(self) -> dict | None:
|
|
"""
|
|
Returns the slot schema for this intent.
|
|
"""
|
|
return {
|
|
|
|
# slots that determine which media player entity will be used.
|
|
vol.Optional(SLOT_NAME): cv.string,
|
|
vol.Optional(SLOT_AREA): cv.string,
|
|
vol.Optional(SLOT_FLOOR): cv.string,
|
|
vol.Optional(SLOT_PREFERRED_AREA_ID): cv.string,
|
|
vol.Optional(SLOT_PREFERRED_FLOOR_ID): cv.string,
|
|
|
|
# slots for other service arguments.
|
|
vol.Optional(SLOT_DELAY, default=0.50): vol.Any(None, vol.All(vol.Coerce(float), vol.Range(min=0, max=10.0))),
|
|
vol.Optional(SLOT_PLAYER_SHUFFLE_MODE): cv.string,
|
|
}
|
|
|
|
|
|
async def async_HandleIntent(
|
|
self,
|
|
intentObj: Intent,
|
|
intentResponse: IntentResponse
|
|
) -> IntentResponse:
|
|
"""
|
|
Handles the intent.
|
|
|
|
Args:
|
|
intentObj (Intent):
|
|
Intent object.
|
|
intentResponse (IntentResponse)
|
|
Intent response object.
|
|
|
|
Returns:
|
|
An IntentResponse object.
|
|
"""
|
|
# invoke base class method to resolve the player entity and its state.
|
|
playerEntityState:State = await super().async_GetMatchingPlayerState(
|
|
intentObj,
|
|
intentResponse,
|
|
desiredFeatures=MediaPlayerEntityFeature.SEEK | MediaPlayerEntityFeature.PLAY_MEDIA,
|
|
desiredStates=[STATE_PLAYING, STATE_PAUSED],
|
|
desiredStateResponseKey=RESPONSE_PLAYER_NOT_PLAYING_MEDIA,
|
|
requiresSpotifyPremium=True,
|
|
)
|
|
|
|
# if media player was not resolved, then we are done;
|
|
# note that the base class method above already called `async_set_speech` with a response.
|
|
if playerEntityState is None:
|
|
return intentResponse
|
|
|
|
# get optional arguments (if provided).
|
|
delay = intentObj.slots.get(SLOT_DELAY, {}).get(CONF_VALUE, None)
|
|
player_shuffle_mode = intentObj.slots.get(SLOT_PLAYER_SHUFFLE_MODE, {}).get(CONF_VALUE, "on")
|
|
|
|
# set service name and build parameters.
|
|
svcName:str = SERVICE_SPOTIFY_PLAYER_SET_SHUFFLE_MODE
|
|
svcData:dict = \
|
|
{
|
|
"entity_id": playerEntityState.entity_id,
|
|
"state": True if player_shuffle_mode == "on" else False,
|
|
"device_id": "", # always use current device for this service call.
|
|
"delay": delay
|
|
}
|
|
|
|
# call integration service for this intent.
|
|
self.logsi.LogVerbose(STAppMessages.MSG_SERVICE_EXECUTE % (svcName, playerEntityState.entity_id), colorValue=SIColors.Khaki)
|
|
await intentObj.hass.services.async_call(
|
|
DOMAIN,
|
|
svcName,
|
|
svcData,
|
|
blocking=True,
|
|
context=intentObj.context,
|
|
)
|
|
|
|
# return intent response.
|
|
intentResponse.speech_slots = intentObj.slots
|
|
self.logsi.LogObject(SILevel.Verbose, STAppMessages.MSG_INTENT_HANDLER_RESPONSE % (intentObj.intent_type), intentResponse, colorValue=SIColors.Khaki)
|
|
return intentResponse
|