aioamazondevices 1.5.0__py3-none-any.whl → 1.7.0__py3-none-any.whl

aioamazondevices/__init__.py

@@ -1,6 +1,6 @@
 """aioamazondevices library."""
 
-__version__ = "1.5.0"
+__version__ = "1.7.0"
 
 
 from .api import AmazonDevice, AmazonEchoApi

aioamazondevices/api.py

@@ -7,6 +7,7 @@ import secrets
 import uuid
 from dataclasses import dataclass
 from datetime import UTC, datetime, timedelta
+from enum import StrEnum
 from http import HTTPStatus
 from http.cookies import Morsel
 from pathlib import Path
@@ -63,6 +64,22 @@ class AmazonDevice:
     bluetooth_state: bool
 
 
+class AmazonSequenceType(StrEnum):
+    """Amazon sequence types."""
+
+    Announcement = "AlexaAnnouncement"
+    Speak = "Alexa.Speak"
+    Sound = "Alexa.Sound"
+    Music = "Alexa.Music.PlaySearchPhrase"
+
+
+class AmazonMusicSource(StrEnum):
+    """Amazon music sources."""
+
+    Radio = "TUNEIN"
+    AmazonMusic = "AMAZON_MUSIC"
+
+
 class AmazonEchoApi:
     """Queries Amazon for Echo devices."""
 
@@ -601,7 +618,11 @@ class AmazonEchoApi:
         return bool(authenticated)
 
     async def _send_message(
-        self, device: AmazonDevice, message_type: str, message_body: str
+        self,
+        device: AmazonDevice,
+        message_type: str,
+        message_body: str,
+        message_source: AmazonMusicSource | None = None,
     ) -> None:
         """Send message to specific device."""
         locale_data = Locale.parse(f"und_{self._login_country_code}")
@@ -611,13 +632,17 @@ class AmazonEchoApi:
             _LOGGER.warning("Trying to send message before login")
             return
 
+        base_payload = {
+            "deviceType": device.device_type,
+            "deviceSerialNumber": device.serial_number,
+            "locale": locale,
+            "customerId": device.device_owner_customer_id,
+        }
+
         payload: dict[str, Any]
-        if message_type == "Alexa.Speak":
+        if message_type == AmazonSequenceType.Speak:
             payload = {
-                "deviceType": device.device_type,
-                "deviceSerialNumber": device.serial_number,
-                "locale": locale,
-                "customerId": device.device_owner_customer_id,
+                **base_payload,
                 "textToSpeak": message_body,
                 "target": {
                     "customerId": device.device_owner_customer_id,
@@ -630,7 +655,7 @@ class AmazonEchoApi:
                 },
                 "skillId": "amzn1.ask.1p.saysomething",
             }
-        else:
+        elif message_type == AmazonSequenceType.Announcement:
             playback_devices: list[dict[str, str]] = [
                 {
                     "deviceSerialNumber": serial,
@@ -641,10 +666,7 @@ class AmazonEchoApi:
             ]
 
             payload = {
-                "deviceType": device.device_type,
-                "deviceSerialNumber": device.serial_number,
-                "locale": locale,
-                "customerId": device.device_owner_customer_id,
+                **base_payload,
                 "expireAfter": "PT5S",
                 "content": [
                     {
@@ -665,6 +687,19 @@ class AmazonEchoApi:
                 },
                 "skillId": "amzn1.ask.1p.routines.messaging",
             }
+        elif message_type == AmazonSequenceType.Sound:
+            payload = {
+                **base_payload,
+                "soundStringId": message_body,
+                "skillId": "amzn1.ask.1p.sound",
+            }
+        elif message_type == AmazonSequenceType.Music:
+            payload = {
+                **base_payload,
+                "searchPhrase": message_body,
+                "sanitizedSearchPhrase": message_body,
+                "musicProviderId": message_source,
+            }
 
         sequence = {
             "@type": "com.amazon.alexa.behaviors.model.Sequence",
@@ -702,7 +737,7 @@ class AmazonEchoApi:
         message_body: str,
     ) -> None:
         """Call Alexa.Speak to send a message."""
-        return await self._send_message(device, "Alexa.Speak", message_body)
+        return await self._send_message(device, AmazonSequenceType.Speak, message_body)
 
     async def call_alexa_announcement(
         self,
@@ -710,4 +745,25 @@ class AmazonEchoApi:
         message_body: str,
     ) -> None:
         """Call AlexaAnnouncement to send a message."""
-        return await self._send_message(device, "AlexaAnnouncement", message_body)
+        return await self._send_message(
+            device, AmazonSequenceType.Announcement, message_body
+        )
+
+    async def call_alexa_sound(
+        self,
+        device: AmazonDevice,
+        message_body: str,
+    ) -> None:
+        """Call Alexa.Sound to play sound."""
+        return await self._send_message(device, AmazonSequenceType.Sound, message_body)
+
+    async def call_alexa_music(
+        self,
+        device: AmazonDevice,
+        message_body: str,
+        message_source: AmazonMusicSource,
+    ) -> None:
+        """Call Alexa.Music.PlaySearchPhrase to play music."""
+        return await self._send_message(
+            device, AmazonSequenceType.Music, message_body, message_source
+        )

{aioamazondevices-1.5.0.dist-info → aioamazondevices-1.7.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: aioamazondevices
-Version: 1.5.0
+Version: 1.7.0
 Summary: Python library to control Amazon devices
 License: Apache-2.0
 Author: Simone Chemelli
@@ -82,8 +82,8 @@ The script accept command line arguments or a library_test.json config file:
   "country": "IT",
   "email": "<my_address@gmail.com>",
   "password": "<my_password>",
-  "device_name_speak": "Echo Dot Livingroom",
-  "device_name_announcement": "Everywhere",
+  "single_device_name": "Echo Dot Livingroom",
+  "cluster_device_name": "Everywhere",
   "login_data_file": "out/login_data.json",
   "save_raw_data": "True"
 }

aioamazondevices-1.7.0.dist-info/RECORD

@@ -0,0 +1,9 @@
+aioamazondevices/__init__.py,sha256=L4W0ORfkNA0DX8VpSFxeXgqh0SCV-FEGz1MGVY5suBc,276
+aioamazondevices/api.py,sha256=MqUfScgFXiD26AOSZfpKPN78xysmOkq7g-p2KutN9vs,27392
+aioamazondevices/const.py,sha256=6BBEg_q2BkYVYJcz3hMrLNyEwOJBWziPSStMzftWQLg,2106
+aioamazondevices/exceptions.py,sha256=qK_Hak9pc-lC2FPW-0i4rYIwNpEOHMmA9Rii8F2lkQo,1260
+aioamazondevices/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+aioamazondevices-1.7.0.dist-info/LICENSE,sha256=sS48k5sp9bFV-NSHDfAJuTZZ_-AP9ZDqUzQ9sffGlsg,11346
+aioamazondevices-1.7.0.dist-info/METADATA,sha256=dxCWOsgRGz6qydT8btCfigvN9DZeYHkOvgmB5mRdbO8,5010
+aioamazondevices-1.7.0.dist-info/WHEEL,sha256=b4K_helf-jlQoXBBETfwnf4B04YC67LOev0jo4fX5m8,88
+aioamazondevices-1.7.0.dist-info/RECORD,,

aioamazondevices-1.5.0.dist-info/RECORD

@@ -1,9 +0,0 @@
-aioamazondevices/__init__.py,sha256=c7Bi99W-tVQoCNwjK33ROJQCAZG1GcwSjaCvz9kMOwM,276
-aioamazondevices/api.py,sha256=_4kojHD_86milDMLrbVscHgNg9nerq8mE6k7xOXOAeE,25874
-aioamazondevices/const.py,sha256=6BBEg_q2BkYVYJcz3hMrLNyEwOJBWziPSStMzftWQLg,2106
-aioamazondevices/exceptions.py,sha256=qK_Hak9pc-lC2FPW-0i4rYIwNpEOHMmA9Rii8F2lkQo,1260
-aioamazondevices/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-aioamazondevices-1.5.0.dist-info/LICENSE,sha256=sS48k5sp9bFV-NSHDfAJuTZZ_-AP9ZDqUzQ9sffGlsg,11346
-aioamazondevices-1.5.0.dist-info/METADATA,sha256=m03j63zvtCHK_AWQbVBSaUsB5yRhlZTSWVPtZ389xdo,5014
-aioamazondevices-1.5.0.dist-info/WHEEL,sha256=b4K_helf-jlQoXBBETfwnf4B04YC67LOev0jo4fX5m8,88
-aioamazondevices-1.5.0.dist-info/RECORD,,