avplayer 0.6.0

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
73
74
75
76
77
78
79
80
81
82

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

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

use crate::asset::{Asset, UrlAsset};
use crate::error::{from_swift, AVPlayerError};
use crate::ffi;
use crate::util::parse_json_and_free;

#[derive(Debug, Clone, PartialEq, Eq)]
#[non_exhaustive]
pub enum AssetPlaybackConfigurationOption {
    StereoVideo,
    StereoMultiviewVideo,
    SpatialVideo,
    NonRectilinearProjection,
    AppleImmersiveVideo,
    Unknown(String),
}

impl AssetPlaybackConfigurationOption {
    fn from_raw(raw: &str) -> Self {
        match raw {
            "stereo_video" => Self::StereoVideo,
            "stereo_multiview_video" => Self::StereoMultiviewVideo,
            "spatial_video" => Self::SpatialVideo,
            "non_rectilinear_projection" => Self::NonRectilinearProjection,
            "apple_immersive_video" => Self::AppleImmersiveVideo,
            other => Self::Unknown(other.to_owned()),
        }
    }
}

#[derive(Debug)]
pub struct AssetPlaybackAssistant {
    ptr: *mut c_void,
}

impl Drop for AssetPlaybackAssistant {
    fn drop(&mut self) {
        if !self.ptr.is_null() {
            unsafe { ffi::av_ns_object_release(self.ptr) };
            self.ptr = ptr::null_mut();
        }
    }
}

impl Asset {
    pub fn playback_assistant(&self) -> Result<AssetPlaybackAssistant, AVPlayerError> {
        let mut err: *mut c_char = ptr::null_mut();
        let ptr = unsafe { ffi::av_asset_playback_assistant_create(self.ptr, &mut err) };
        if ptr.is_null() {
            return Err(unsafe { from_swift(ffi::status::OPERATION_FAILED, err) });
        }
        Ok(AssetPlaybackAssistant { ptr })
    }
}

impl UrlAsset {
    pub fn playback_assistant(&self) -> Result<AssetPlaybackAssistant, AVPlayerError> {
        self.asset.playback_assistant()
    }
}

impl AssetPlaybackAssistant {
    pub fn playback_configuration_options(
        &self,
    ) -> Result<Vec<AssetPlaybackConfigurationOption>, AVPlayerError> {
        let mut err: *mut c_char = ptr::null_mut();
        let json_ptr =
            unsafe { ffi::av_asset_playback_assistant_copy_options_json(self.ptr, &mut err) };
        if json_ptr.is_null() {
            return Err(unsafe { from_swift(ffi::status::OPERATION_FAILED, err) });
        }
        let raw: Vec<String> = parse_json_and_free(json_ptr)?;
        Ok(raw
            .into_iter()
            .map(|value| AssetPlaybackConfigurationOption::from_raw(&value))
            .collect())
    }
}