mirror of
https://github.com/koush/scrypted.git
synced 2026-08-01 19:00:37 +01:00
ade34b7da6
* fix(alexa): v3 API compliance fixes, fan speed, and security panel control Bring the Alexa Smart Home integration in line with the current v3 API. Tier 1 (malformed responses / missing handlers): - BrightnessController: report brightness under the Alexa.BrightnessController namespace instead of Alexa.PowerController so Set/AdjustBrightness responses match the advertised capability. - SmartVision ObjectDetection: flatten the doubly-nested payload.events array. - SecurityPanelController: add Arm/Disarm directive handlers (previously advertised but unhandled, silently falling through to a fake success), wired to armSecuritySystem/disarmSecuritySystem. Enforce the spec rule rejecting a direct ARMED_AWAY -> other armed-state transition with AUTHORIZATION_REQUIRED. Drop the advertised FOUR_DIGIT_PIN authorization, which Scrypted cannot honor. - Auth failures now return an Alexa INVALID_AUTHORIZATION_CREDENTIAL ErrorResponse instead of a bare HTTP 500 that Alexa retries and surfaces as a generic skill error. API modernization: - EndpointHealth: downgrade to the documented v3.1 / connectivity-only shape and stop emitting the undocumented battery property (and 3.2 version), which risks the whole capability being rejected. - Fan: add Alexa.RangeController (Fan.Speed, 0-100%) for devices implementing the Fan interface, alongside the existing PowerController on/off. Cleanups: - addAccessToken: initialize event.endpoint as an object, not an array. - Hoist getArmState to a shared export instead of duplicating it. Bump version to 0.4.0. * fix(alexa): improve camera stream quality and connectivity Tune the WebRTC negotiation for Alexa camera sessions. - Resolution: raise the proxied stream cap from 720p to 1080p. The previous 1280x720 screen hint forced the transcoder into medium-resolution mode for every endpoint, so even an Echo Show 15 or Fire TV only received 720p. 1080p lets larger displays render sharply while the transcoder still clamps width and falls back to 720p when H.264 High can't be negotiated. We cap rather than send the uncapped source, since Alexa's directive carries no display hint and a 4K stream would waste bandwidth on smaller Echo devices. - Two-way audio: only advertise isFullDuplexAudioSupported when the camera implements the Intercom interface. Advertising full duplex on a one-way camera makes Alexa set up a return mic path that goes nowhere. - TURN: stop unconditionally disabling TURN, and expose a "Use TURN Servers" plugin setting (on by default). Alexa sessions are proxied and often cross NATs where a TURN relay is the only path that connects; combined with disabled trickle ICE (all candidates in the initial SDP), omitting the relay candidate left NAT-blocked sessions with no fallback. When enabled, TURN usage defers to the WebRTC plugin's own setting, matching the Google Home integration; disabling it force-disables TURN for Alexa sessions only. Bump version to 0.5.0.
Alexa Plugin for Scrypted
The Alexa Plugin lets you control your Scrypted devices from Amazon Alexa.
Setup
- Install the Scrypted Cloud plugin (@scrypted/cloud).
- Log in to Scrypted Cloud.
- Install this plugin.
- Install via Alexa app on your mobile device or via the browser
- Mobile Device
- Open the Alexa app
- Click More > Skills & Games
- Click Search icon in top right
- Type "scrypted" and then search
- Click 'Scrypted Home Automation'
- Click 'Enable To Use'
- Browser
- Click this link
- Note if your default marketplace isn't
amazon.com, replace the domain with your default marketplace. - Click 'Enable'
- Mobile Device
- Follow on-screen prompts and log in to Scrypted with the same account from the step 2.
Your devices should now sync with Amazon Alexa.