Struct MediaStreamClassifierRegistry

Source

pub struct MediaStreamClassifierRegistry { /* private fields */ }

Expand description

Registry of media stream classifier providers.

Provider names and aliases are matched case-insensitively. Duplicate ids or aliases are rejected at registration time so a selector always resolves to at most one provider.

MediaStreamClassifierRegistry::create_default_box and MediaStreamClassifierRegistry::create_default_arc read MimeConfig::media_stream_classifier_default first. When the configured selector is empty or auto, the registry tries all available providers ordered by descending provider priority and then by provider id. Otherwise it creates the named provider.

Implementations§

Source §

impl MediaStreamClassifierRegistry

Source

pub fn new() -> Self

Creates an empty classifier registry.

§Returns

Empty registry.

Source

pub fn builtin() -> Self

Creates a registry containing only built-in classifier providers.

§Returns

Registry with the FFprobe provider.

Source

pub fn default_registry() -> MimeResult<Self>

Gets a snapshot of the process-wide default classifier registry.

The returned registry is cloned from the global default registry, so callers can inspect or create classifiers without holding a global lock.

§Returns

Snapshot of the default registry.

§Errors

Returns MimeError::ClassifierBackend when the global registry lock has been poisoned by another thread.

Source

pub fn register_default(provider: P) -> MimeResult<()>
where P: MediaStreamClassifierProvider + 'static,

Registers a provider in the process-wide default classifier registry.

Successfully registered providers become visible to MediaStreamClassifierRegistry::default_registry snapshots throughout the current process.

§Parameters

provider: Provider to register globally.

§Errors

Returns MimeError::DuplicateClassifierName when the provider id or one of its aliases already exists in the default registry. Returns MimeError::ClassifierBackend when the global registry lock has been poisoned by another thread.

Source

pub fn register(&mut self, provider: P) -> MimeResult<()>
where P: MediaStreamClassifierProvider + 'static,

Registers a provider.

§Parameters

provider: Provider to register.

§Errors

Returns MimeError::DuplicateClassifierName when the provider id or one of its aliases conflicts with an existing provider.

Source

pub fn register_shared(&mut self, provider: Arc) -> MimeResult<()>
where P: MediaStreamClassifierProvider + 'static,

Registers a shared provider.

§Parameters

provider: Shared provider to register.

§Errors

Returns a MimeError when the provider descriptor is invalid or one of its names conflicts with an existing provider.

Source

pub fn register_arc(&mut self, provider: Arc) -> MimeResult<()>
where P: MediaStreamClassifierProvider + 'static,

Registers a shared provider.

§Parameters

provider: Shared provider to register.

§Errors

Returns a MimeError when the provider descriptor is invalid or one of its names conflicts with an existing provider.

Source

pub fn provider_names(&self) -> Vec<&str>

Gets canonical provider names in registration order.

§Returns

Provider ids.

Source

pub fn find_provider( &self, name: &str, ) -> Option<&dyn ServiceProvider<MediaStreamClassifierSpec>>

Finds a provider by id or alias.

§Parameters

name: Provider id or alias. Matching is case-insensitive.

§Returns

Matching provider, or None.

Source

pub fn resolve_provider( &self, name: &str, ) -> MimeResult<&dyn ServiceProvider<MediaStreamClassifierSpec>>

Resolves a provider by id or alias.

§Parameters

name: Provider id or alias. Names are normalized before lookup.

§Returns

Matching provider.

§Errors

Returns MimeError::EmptyClassifierName or MimeError::InvalidClassifierName when name is invalid, or MimeError::UnknownClassifier when no provider matches.

Source

pub fn create_box( &self, name: &str, config: &MimeConfig, ) -> MimeResult<Box<dyn MediaStreamClassifier>>

Creates a boxed classifier from a provider name.

§Parameters

name: Provider id or alias.
config: MIME configuration passed to the provider.

§Returns

Boxed media stream classifier trait object.

§Errors

Returns MimeError::UnknownClassifier when no provider matches name, MimeError::ClassifierUnavailable when the provider is unavailable, or another MimeError when provider initialization fails.

Source

pub fn create_arc( &self, name: &str, config: &MimeConfig, ) -> MimeResult<Arc<dyn MediaStreamClassifier>>

Creates a shared classifier from a provider name.

§Parameters

name: Provider id or alias.
config: MIME configuration passed to the provider.

§Returns

Shared media stream classifier trait object.

§Errors

Returns MimeError::UnknownClassifier when no provider matches name, MimeError::ClassifierUnavailable when the provider is unavailable, or another MimeError when provider initialization fails.

Source