avplayer 0.3.3

Safe Rust bindings for Apple's AVPlayer + AVAssetReader — playback and frame-by-frame asset reading on macOS
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72

#![allow(clippy::missing_errors_doc, clippy::must_use_candidate)]

use core::ffi::{c_char, c_void};
use core::marker::PhantomData;
use core::ptr;

use crate::error::{from_swift, AVPlayerError};
use crate::ffi;
use crate::time::Time;
use crate::util::parse_json_and_free;

/// Borrowed view of the abstract `AVPlayerItemOutput` base class.
#[derive(Debug, Clone, Copy)]
pub struct PlayerItemOutput<'a> {
    pub(crate) ptr: *mut c_void,
    _marker: PhantomData<&'a c_void>,
}

// SAFETY: Borrowed AVPlayerItemOutput handles are safe to transfer across
// thread boundaries while borrowed; method calls are internally dispatched
// safely.
unsafe impl Send for PlayerItemOutput<'_> {}

impl PlayerItemOutput<'_> {
    pub(crate) const fn from_ptr(ptr: *mut c_void) -> Self {
        Self {
            ptr,
            _marker: PhantomData,
        }
    }

    pub fn suppresses_player_rendering(&self) -> bool {
        unsafe { ffi::av_player_item_output_suppresses_player_rendering(self.ptr) }
    }

    pub fn set_suppresses_player_rendering(&self, suppresses: bool) {
        unsafe { ffi::av_player_item_output_set_suppresses_player_rendering(self.ptr, suppresses) };
    }

    pub fn item_time_for_host_time(&self, host_time_seconds: f64) -> Result<Time, AVPlayerError> {
        let mut err: *mut c_char = ptr::null_mut();
        let json_ptr = unsafe {
            ffi::av_player_item_output_item_time_for_host_time_json(
                self.ptr,
                host_time_seconds,
                &mut err,
            )
        };
        if json_ptr.is_null() {
            return Err(unsafe { from_swift(ffi::status::OPERATION_FAILED, err) });
        }
        parse_json_and_free(json_ptr)
    }

    pub fn item_time_for_mach_absolute_time(
        &self,
        mach_absolute_time: i64,
    ) -> Result<Time, AVPlayerError> {
        let mut err: *mut c_char = ptr::null_mut();
        let json_ptr = unsafe {
            ffi::av_player_item_output_item_time_for_mach_absolute_time_json(
                self.ptr,
                mach_absolute_time,
                &mut err,
            )
        };
        if json_ptr.is_null() {
            return Err(unsafe { from_swift(ffi::status::OPERATION_FAILED, err) });
        }
        parse_json_and_free(json_ptr)
    }
}