eric/pmomusic
1
0
Fork 0
Code Issues 5 Pull Requests Actions Packages Projects Releases 3 Wiki Activity

Implementation de rendering control

Browse Source
This commit is contained in:
Eric Coissac
2025-10-05 20:53:05 +02:00
parent 5c0a8ba392
commit ad51fc952a
12 changed files with 185 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

1
pmoupnp/src/mediarenderer/mod.rs
View File

@@ -1 +1,2 @@
pub mod avtransport;
pub mod renderingcontrol;

10
pmoupnp/src/mediarenderer/renderingcontrol/actions/getmute.rs Normal file
View File

@@ -0,0 +1,10 @@
use crate::mediarenderer::renderingcontrol::variables::{A_ARG_TYPE_INSTANCE_ID, A_ARG_TYPE_CHANNEL, MUTE};
use crate::define_action;
define_action! {
pub static GETMUTE = "GetMute" {
in "InstanceID" => A_ARG_TYPE_INSTANCE_ID,
in "Channel" => A_ARG_TYPE_CHANNEL,
out "CurrentMute" => MUTE,
}
}

10
pmoupnp/src/mediarenderer/renderingcontrol/actions/getvolume.rs Normal file
View File

@@ -0,0 +1,10 @@
use crate::mediarenderer::renderingcontrol::variables::{A_ARG_TYPE_INSTANCE_ID, A_ARG_TYPE_CHANNEL, VOLUME};
use crate::define_action;
define_action! {
pub static GETVOLUME = "GetVolume" {
in "InstanceID" => A_ARG_TYPE_INSTANCE_ID,
in "Channel" => A_ARG_TYPE_CHANNEL,
out "CurrentVolume" => VOLUME,
}
}

9
pmoupnp/src/mediarenderer/renderingcontrol/actions/mod.rs Normal file
View File

@@ -0,0 +1,9 @@
mod getvolume;
mod setvolume;
mod getmute;
mod setmute;
pub use getvolume::GETVOLUME;
pub use setvolume::SETVOLUME;
pub use getmute::GETMUTE;
pub use setmute::SETMUTE;

10
pmoupnp/src/mediarenderer/renderingcontrol/actions/setmute.rs Normal file
View File

@@ -0,0 +1,10 @@
use crate::mediarenderer::renderingcontrol::variables::{A_ARG_TYPE_INSTANCE_ID, A_ARG_TYPE_CHANNEL, MUTE};
use crate::define_action;
define_action! {
pub static SETMUTE = "SetMute" {
in "InstanceID" => A_ARG_TYPE_INSTANCE_ID,
in "Channel" => A_ARG_TYPE_CHANNEL,
in "DesiredMute" => MUTE,
}
}

10
pmoupnp/src/mediarenderer/renderingcontrol/actions/setvolume.rs Normal file
View File

@@ -0,0 +1,10 @@
use crate::mediarenderer::renderingcontrol::variables::{A_ARG_TYPE_INSTANCE_ID, A_ARG_TYPE_CHANNEL, VOLUME};
use crate::define_action;
define_action! {
pub static SETVOLUME = "SetVolume" {
in "InstanceID" => A_ARG_TYPE_INSTANCE_ID,
in "Channel" => A_ARG_TYPE_CHANNEL,
in "DesiredVolume" => VOLUME,
}
}

99
pmoupnp/src/mediarenderer/renderingcontrol/mod.rs Normal file
View File

@@ -0,0 +1,99 @@
//! # RenderingControl Service - Service de contrôle du rendu audio UPnP
//!
//! Ce module implémente le service RenderingControl:1 selon la spécification UPnP AV.
//! Le service RenderingControl permet de contrôler les paramètres de rendu audio
//! (volume, mute, etc.) sur un MediaRenderer.
//!
//! ## Fonctionnalités
//!
//! Le service RenderingControl permet :
//! - **Contrôle du volume** : GetVolume, SetVolume
//! - **Contrôle du mute** : GetMute, SetMute
//! - Support multi-canal (Master, LF, RF)
//!
//! ## Conformité UPnP
//!
//! Cette implémentation suit la spécification **UPnP RenderingControl:1 Service Template**.
//! Toutes les actions obligatoires (Required) sont implémentées :
//!
//! - ✅ GetVolume
//! - ✅ SetVolume
//! - ✅ GetMute
//! - ✅ SetMute
//!
//! ## Variables d'état
//!
//! Le service expose les variables d'état conformes à la spécification :
//!
//! ### Contrôle audio
//! - [`VOLUME`] : Niveau de volume (0-100)
//! - [`MUTE`] : État mute (true/false)
//!
//! ### Arguments
//! - [`A_ARG_TYPE_INSTANCE_ID`] : ID d'instance
//! - [`A_ARG_TYPE_CHANNEL`] : Canal audio (Master, LF, RF)
//!
//! ## Examples
//!
//! ```rust
//! use pmoupnp::mediarenderer::renderingcontrol::RENDERINGCONTROL;
//!
//! // Accéder au service
//! let service = &*RENDERINGCONTROL;
//! println!("Service: {}", service.name());
//! println!("Type: {}", service.service_type());
//! ```
//!
//! ## Références
//!
//! - [UPnP RenderingControl:1 Service Template](https://upnp.org/specs/av/UPnP-av-RenderingControl-v1-Service.pdf)
//! - [UPnP AV Architecture](https://upnp.org/specs/av/)
use crate::define_service;
pub mod variables;
pub mod actions;
use actions::{GETMUTE, GETVOLUME, SETMUTE, SETVOLUME};
use variables::{A_ARG_TYPE_CHANNEL, A_ARG_TYPE_INSTANCE_ID, MUTE, VOLUME};
/// Service RenderingControl:1 conforme à la spécification UPnP AV.
///
/// Ce service permet de contrôler les paramètres de rendu audio sur un MediaRenderer.
///
/// # Initialisation
///
/// Le service est initialisé paresseusement (lazy) au premier accès via la macro
/// [`define_service!`]. Toutes les variables d'état et actions sont automatiquement
/// enregistrées.
///
/// # Exemples
///
/// ```rust
/// use pmoupnp::mediarenderer::renderingcontrol::RENDERINGCONTROL;
///
/// let service = &*RENDERINGCONTROL;
/// assert_eq!(service.name(), "RenderingControl");
/// assert_eq!(service.version(), 1);
/// ```
///
/// # Voir aussi
///
/// - Module [`actions`] : Définition de toutes les actions UPnP
/// - Module [`variables`] : Définition de toutes les variables d'état
define_service! {
pub static RENDERINGCONTROL = "RenderingControl" {
variables: [
A_ARG_TYPE_CHANNEL,
A_ARG_TYPE_INSTANCE_ID,
MUTE,
VOLUME,
],
actions: [
GETMUTE,
GETVOLUME,
SETMUTE,
SETVOLUME,
]
}
}

8
pmoupnp/src/mediarenderer/renderingcontrol/variables/a_arg_type_channel.rs Normal file
View File

@@ -0,0 +1,8 @@
use crate::define_variable;
define_variable! {
pub static A_ARG_TYPE_CHANNEL: String = "A_ARG_TYPE_Channel" {
allowed: ["Master", "LF", "RF"],
default: "Master",
}
}

5
pmoupnp/src/mediarenderer/renderingcontrol/variables/a_arg_type_instanceid.rs Normal file
View File

@@ -0,0 +1,5 @@
use crate::define_variable;
define_variable! {
pub static A_ARG_TYPE_INSTANCE_ID: UI4 = "A_ARG_TYPE_InstanceID"
}

9
pmoupnp/src/mediarenderer/renderingcontrol/variables/mod.rs Normal file
View File

@@ -0,0 +1,9 @@
mod a_arg_type_instanceid;
mod a_arg_type_channel;
mod volume;
mod mute;
pub use a_arg_type_instanceid::A_ARG_TYPE_INSTANCE_ID;
pub use a_arg_type_channel::A_ARG_TYPE_CHANNEL;
pub use volume::VOLUME;
pub use mute::MUTE;

7
pmoupnp/src/mediarenderer/renderingcontrol/variables/mute.rs Normal file
View File

@@ -0,0 +1,7 @@
use crate::define_variable;
define_variable! {
pub static MUTE: Boolean = "Mute" {
evented: true,
}
}

7
pmoupnp/src/mediarenderer/renderingcontrol/variables/volume.rs Normal file
View File

@@ -0,0 +1,7 @@
use crate::define_variable;
define_variable! {
pub static VOLUME: UI2 = "Volume" {
evented: true,
}
}