RealityServer Web Services API Programmer's Manual

mi::rswservices::IConfiguration Class Reference

[Configuration]

Description

Exposes RealityServer configuration.

Public Member Functions

virtual const char* get_content_root() const =0
Returns the absolute path to the content root. More...
virtual const char* get_default_video_codec() const =0
Gets the name of the default video codec type for RTMP streaming. More...
virtual const IDirectory_configurationget_directory( const char* pattern) const =0
Returns a Directory configuration by pattern. More...
virtual const IDirectory_configurationget_directory( mi::Uint32 index) const =0
Returns a Directory configuration by index. More...
virtual const char* get_http_address() const =0
Returns the HTTP address that RealityServer is listening on. More...
virtual const char* get_http_identification() const =0
Retrieves the HTTP identification string. More...
virtual mi::Sint32 get_http_keep_alive_timeout() const =0
Retrieves the idle timeout for keep-alive connections. More...
virtual Uint32 get_http_post_body_limit() const =0
Returns the size limit for the body of HTTP POST requests.
virtual mi::Uint64 get_http_send_buffer_size() const =0
Gets the HTTP send buffer size. More...
virtual const char* get_mime_type( const char* extension) const =0
Returns the mime type associated with the given extension. More...
virtual bool  get_mime_type( mi::Uint32 index, const char** extension, const char** mime_type) const =0
Retrieve a mime type by index. More...
virtual const INeuray_configurationget_neuray_configuration() const =0
Retrieves the neuray library configuration interface.
virtual const char* get_root() const =0
Returns the absolute path to the RealityServer root. More...
virtual const char* get_rtmp_address() const =0
Returns the RTMP address that RealityServer is listening on. More...
virtual bool  get_uac_auto_session() const =0
Returns wheture UAC is using auto session assignment or not.
virtual const char* get_uac_management_base_url() const =0
Returns the base URL used for UAC management.
virtual Size get_uac_sesion_timeout() const =0
Returns the UAC session timeout in seconds. More...
virtual const char* get_uac_session_cookie() const =0
Returns the name of the session cookie used for UAC control.
virtual const char* get_uac_session_cookie_domain() const =0
Returns the name of the domain that is provided with the UAC set-cookie header. More...
virtual Size get_uac_user_limit() const =0
Returns the UAC user limit. If 0 then user limiting is disabled.
virtual const IUrl_configurationget_url( const char* pattern) const =0
Returns a URL configuration by pattern. More...
virtual const IUrl_configurationget_url( mi::Uint32 index) const =0
Returns a URL configuration by index. More...
virtual const IUser_configurationget_user( const char* name) const =0
Returns a user configuration set. More...

Member Functions

virtual const char* mi::​rswservices::​IConfiguration::get_content_root() const [pure virtual]

Returns the absolute path to the content root.

Returns

the content root path

virtual const char* mi::​rswservices::​IConfiguration::get_default_video_codec() const [pure virtual]

Gets the name of the default video codec type for RTMP streaming. Note that this returns the name of the codec actually used. If the configured codec is not available then this will fallback to a different value.

Returns

the codec type or NULL if RTMP is not enabled or no supported codecs are installed.

virtual const IDirectory_configuration* mi::​rswservices::​IConfiguration::get_directory( const char* pattern) const [pure virtual]

Returns a Directory configuration by pattern. Note that pattern must match exactly what is specified as the pattern in the configuration file.

Parameters

pattern
the patter to retrieve Directory configuration for.

Returns

the Directory configuration or NULL if no configuration is specified for pattern .

virtual const IDirectory_configuration* mi::​rswservices::​IConfiguration::get_directory( mi::Uint32 index) const [pure virtual]

Returns a Directory configuration by index.

Parameters

index
the index of the configuration to retrieve.

Returns

the Directory configuration or NULL if index is greater than the number of Directory configurations.

virtual const char* mi::​rswservices::​IConfiguration::get_http_address() const [pure virtual]

Returns the HTTP address that RealityServer is listening on.

Returns

the address

virtual const char* mi::​rswservices::​IConfiguration::get_http_identification() const [pure virtual]

Retrieves the HTTP identification string.

Returns

the HTTP identification string.

virtual mi::Sint32 mi::​rswservices::​IConfiguration::get_http_keep_alive_timeout() const [pure virtual]

Retrieves the idle timeout for keep-alive connections.

Returns

the idle timeout for keep-alive connections.

virtual Uint32 mi::​rswservices::​IConfiguration::get_http_post_body_limit() const [pure virtual]

Returns the size limit for the body of HTTP POST requests.

virtual mi::Uint64 mi::​rswservices::​IConfiguration::get_http_send_buffer_size() const [pure virtual]

Gets the HTTP send buffer size.

Returns

the HTTP send buffer size.

virtual const char* mi::​rswservices::​IConfiguration::get_mime_type( const char* extension) const [pure virtual]

Returns the mime type associated with the given extension.

Parameters

extension
the extension

Returns

the mime type or NULL if none configured

virtual bool mi::​rswservices::​IConfiguration::get_mime_type( mi::Uint32 index, const char** extension, const char** mime_type) const [pure virtual]

Retrieve a mime type by index.

Parameters

index
the index of the mime type to retrieve.
extension
if not NULL receives the extension for the mime type.
mime_type
if not NULL receives the mime type.

Returns

true on success, false if index is greater than the number of mime types.

virtual const INeuray_configuration* mi::​rswservices::​IConfiguration::get_neuray_configuration() const [pure virtual]

Retrieves the neuray library configuration interface.

virtual const char* mi::​rswservices::​IConfiguration::get_root() const [pure virtual]

Returns the absolute path to the RealityServer root. This is the path in which the configuration file can be found.

Returns

the root path

virtual const char* mi::​rswservices::​IConfiguration::get_rtmp_address() const [pure virtual]

Returns the RTMP address that RealityServer is listening on.

Returns

the address or NULL if the RTMP server is not enabled.

virtual bool mi::​rswservices::​IConfiguration::get_uac_auto_session() const [pure virtual]

Returns wheture UAC is using auto session assignment or not.

virtual const char* mi::​rswservices::​IConfiguration::get_uac_management_base_url() const [pure virtual]

Returns the base URL used for UAC management.

virtual Size mi::​rswservices::​IConfiguration::get_uac_sesion_timeout() const [pure virtual]

Returns the UAC session timeout in seconds. If a session is not accessed within this many seconds it is destroyed and the user slot is made available.

virtual const char* mi::​rswservices::​IConfiguration::get_uac_session_cookie() const [pure virtual]

Returns the name of the session cookie used for UAC control.

virtual const char* mi::​rswservices::​IConfiguration::get_uac_session_cookie_domain() const [pure virtual]

Returns the name of the domain that is provided with the UAC set-cookie header. Returns NULL if no explicit domain is used.

virtual Size mi::​rswservices::​IConfiguration::get_uac_user_limit() const [pure virtual]

Returns the UAC user limit. If 0 then user limiting is disabled.

virtual const IUrl_configuration* mi::​rswservices::​IConfiguration::get_url( const char* pattern) const [pure virtual]

Returns a URL configuration by pattern. Note that pattern must match exactly what is specified as the pattern in the configuration file.

Parameters

pattern
the pattern to retrieve the URL configuration for.

Returns

the URL configuration or NULL if no configuration is specified for pattern .

virtual const IUrl_configuration* mi::​rswservices::​IConfiguration::get_url( mi::Uint32 index) const [pure virtual]

Returns a URL configuration by index.

Parameters

index
the index of the configuration to retrieve.

Returns

the URL configuration or NULL if index is greater than the number of URL configurations.

virtual const IUser_configuration* mi::​rswservices::​IConfiguration::get_user( const char* name) const [pure virtual]

Returns a user configuration set.

Parameters

name
the name of the user configuration to retrieve

Returns

the configuration or NULL if not found