treble_tsdk.scene.audio_loader_registry

Classes

AudioLoaderRegistry

Global registry for audio loaders.
class treble_tsdk.scene.audio_loader_registry.AudioLoaderRegistry

Global registry for audio loaders. Loaders are registered with a unique key and can be retrieved by that key during deserialization.

classmethod is_registered(loader_key: str, loader_url: str | Path) → bool

Return whether a loader instance is already registered.

Parameters:

  • loader_key – Unique identifier for the loader type.

  • loader_url – Source URL or path to check.

Returns:

True if already registered, False otherwise.

classmethod register(loader_key: str, loader_url: str | Path, loader: Callable) → None

Register a loader instance, also registering its class (if not already registered) so get() can later construct new instances of the same type for other URLs.

Parameters:

  • loader_key – Unique identifier for the loader type.

  • loader_url – Source URL or path the loader instance was created for.

  • loader – The loader instance to register.

classmethod register_loader_class(loader_key: str, loader_class: type[Callable], cache_directory: Path | None, loader_kwargs: dict[str, object] | None = None) → None

Register a loader class.

Parameters:

  • loader_key – Unique identifier for the loader type.

  • loader_class – The loader class to instantiate on retrieval.

  • cache_directory – Default cache directory passed to the loader constructor.

  • loader_kwargs – Default keyword arguments passed to the loader constructor.