An asynchronous library for finding UPnP control points, performing actions on them and reading their service descriptions. UPnP stand for Universal Plug and Play and is widely used for routers, WiFi-enabled speakers and media servers.
Spec: http://rupnp.org/specs/arch/UPnP-arch-DeviceArchitecture-v2.0.pdf
The following code searches for devices that have a RenderingControl service and print their names along with their current volume.
use futures::prelude::*; use std::time::Duration; use rupnp::ssdp::{SearchTarget, URN}; const RENDERING_CONTROL: URN = URN::service("schemas-upnp-org", "RenderingControl", 1); #[tokio::main] async fn main() -> Result<(), rupnp::Error> { let search_target = SearchTarget::URN(RENDERING_CONTROL); let devices = rupnp::discover(search_target, Duration::from_secs(3)).await?; pin_utils::pin_mut!(devices); while let Some(device) = devices.try_next().await? { let service = device .find_service(&RENDERING_CONTROL) .expect("searched for RenderingControl, got something else"); let args = "<InstanceID>0</InstanceID><Channel>Master</Channel>"; let response = service.action(device.url(), "GetVolume", args).await?; let volume = response.get("CurrentVolume").unwrap(); println!("'{}' is at volume {}", device.friendly_name(), volume); } Ok(()) }Licensed under either of
- Apache License, Version 2.0 (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
- MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)
at your option.
Please use rustfmt before any pull requests.
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.