Struct Media

pub struct Media { /* private fields */ }

Implementations

impl Media

pub fn new_location(instance: &Instance, mrl: &str) -> Option<Media>

Create a media with a certain given media resource location, for instance a valid URL.

pub fn new_path<T: AsRef<Path>>(instance: &Instance, path: T) -> Option<Media>

Create a media for a certain file path.

Examples found in repository

examples/cli_player.rs (line 23)

fn main() {
    let args: Vec<String> = std::env::args().collect();

    let path = match args.get(1) {
        Some(s) => s,
        None => {
            println!("Usage: cli_audio_player path_to_a_media_file");
            return;
        }
    };
    let instance = Instance::new().unwrap();
    
    let md = Media::new_path(&instance, path).unwrap();    
    let mdp = MediaPlayer::new(&instance).unwrap();
    
    let (tx, rx) = channel::<()>();
    
    let em = md.event_manager();
    let _ = em.attach(EventType::MediaStateChanged, move |e, _| {
        match e {
            Event::MediaStateChanged(s) => {
                println!("State : {:?}", s);
                if s == State::Ended || s == State::Error {
                    tx.send(()).unwrap();
                }
            },
            _ => (),
        }
    });
    
    mdp.set_media(&md);
    
    // Start playing
    mdp.play().unwrap();
    
    // Wait for end state
    rx.recv().unwrap();    
}

pub fn new_fd(instance: &Instance, fd: i32) -> Option<Media>

pub fn mrl(&self) -> Option<String>

pub fn event_manager<'a>(&'a self) -> EventManager<'a>

Examples found in repository

examples/cli_player.rs (line 28)

fn main() {
    let args: Vec<String> = std::env::args().collect();

    let path = match args.get(1) {
        Some(s) => s,
        None => {
            println!("Usage: cli_audio_player path_to_a_media_file");
            return;
        }
    };
    let instance = Instance::new().unwrap();
    
    let md = Media::new_path(&instance, path).unwrap();    
    let mdp = MediaPlayer::new(&instance).unwrap();
    
    let (tx, rx) = channel::<()>();
    
    let em = md.event_manager();
    let _ = em.attach(EventType::MediaStateChanged, move |e, _| {
        match e {
            Event::MediaStateChanged(s) => {
                println!("State : {:?}", s);
                if s == State::Ended || s == State::Error {
                    tx.send(()).unwrap();
                }
            },
            _ => (),
        }
    });
    
    mdp.set_media(&md);
    
    // Start playing
    mdp.play().unwrap();
    
    // Wait for end state
    rx.recv().unwrap();    
}

pub fn get_meta(&self, meta: Meta) -> Option<String>

Read the meta of the media. If the media has not yet been parsed this will return None.

pub fn set_meta(&self, meta: Meta, value: &str)

Set the meta of the media. (This function will not save the meta, call save_meta in order to save the meta)

pub fn save_meta(&self) -> bool

Save the meta previously set.

pub fn state(&self) -> State

Get current state of media descriptor object.

pub fn duration(&self) -> Option<i64>

Get duration (in ms) of media descriptor object item.

pub fn parse(&self)

Parse a media.

pub fn parse_async(&self)

Parse a media.

pub fn is_parsed(&self) -> bool

Get Parsed status for media descriptor object.

pub fn tracks(&self) -> Option<Vec<MediaTrack>>

pub fn raw(&self) -> *mut libvlc_media_t

Returns raw pointer

Trait Implementations

impl Drop for Media

fn drop(&mut self)

Executes the destructor for this type.