Struct mumble_link::MumbleLink
source · pub struct MumbleLink { /* private fields */ }
Expand description
An active Mumble link connection.
Implementations§
source§impl MumbleLink
impl MumbleLink
sourcepub fn new(name: &str, description: &str) -> Result<MumbleLink>
pub fn new(name: &str, description: &str) -> Result<MumbleLink>
Attempt to open the Mumble link, providing the specified application name and description.
Opening the link will fail if Mumble is not running. If another
application is also using Mumble link, its data may be overwritten or
conflict with this link. To avoid this, use SharedLink
.
sourcepub fn set_context(&mut self, context: &[u8])
pub fn set_context(&mut self, context: &[u8])
Update the context string, used to determine which users on a Mumble server should hear each other positionally.
If context between two Mumble users does not match, the positional audio data is stripped server-side and voice will be received as non-positional. Accordingly, the context should only match for players on the same game, server, and map, depending on the game itself. When in doubt, err on the side of including less; this allows for more flexibility in the future.
The context should be changed infrequently, at most a few times per second.
The context has a maximum length of 256 bytes.
sourcepub fn set_identity(&mut self, identity: &str)
pub fn set_identity(&mut self, identity: &str)
Update the identity, uniquely identifying the player in the given context. This is usually the in-game name or ID.
The identity may also contain any additional information about the player which might be useful for the Mumble server, for example to move teammates to the same channel or give squad leaders additional powers. It is recommended that a parseable format like JSON or CSV is used for this.
The identity should be changed infrequently, at most a few times per second.
The identity has a maximum length of 255 UTF-16 code units.
sourcepub fn update(&mut self, avatar: Position, camera: Position)
pub fn update(&mut self, avatar: Position, camera: Position)
Update the link with the latest position information. Should be called once per frame.
avatar
should be the position of the player. If it is all zero,
positional audio will be disabled. camera
should be the position of
the camera, which may be the same as avatar
.