mediaplayer 0.4.1

Safe Rust bindings for MediaPlayer.framework on macOS — now playing, remote commands, artwork, and explicit iOS-only stubs
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

#![allow(missing_docs)]

use core::ffi::{c_int, c_void};

/// Callback type used by every async-stream bridge.
///
/// * `kind`    — event discriminant (stream-type-specific)
/// * `payload` — pointer to POD event data, or null
/// * `ctx`     — Rust `AsyncStreamSender<T>` pointer (never null)
pub type StreamEventCallback =
    unsafe extern "C" fn(kind: c_int, payload: *const c_void, ctx: *mut c_void);

extern "C" {
    /// Subscribes to one of the four notification-centre streams.
    /// `kind`: 0=NowPlayingItemChanged, 1=PlaybackStateChanged,
    ///         2=VolumeChanged, 3=MediaLibraryChanged
    pub fn mp_notification_subscribe(
        kind: c_int,
        callback: Option<StreamEventCallback>,
        ctx: *mut c_void,
    ) -> *mut c_void;

    /// Cancels a notification subscription and releases the bridge object.
    pub fn mp_notification_unsubscribe(handle: *mut c_void);

    /// Subscribes to a single `MPRemoteCommandCenter` command as a stream.
    /// `command_id` uses the same encoding as `mp_remote_command_add_handler`.
    pub fn mp_stream_remote_command_subscribe(
        command_id: c_int,
        callback: Option<StreamEventCallback>,
        ctx: *mut c_void,
    ) -> *mut c_void;

    /// Cancels a remote-command stream subscription.
    pub fn mp_stream_remote_command_unsubscribe(handle: *mut c_void);

    /// Subscribes to `MPNowPlayingSessionDelegate` events.
    ///
    /// The bundled Swift bridge returns `NULL` on macOS because
    /// `MPNowPlayingSession` is unavailable there.
    pub fn mp_now_playing_session_stream_subscribe(
        callback: Option<StreamEventCallback>,
        ctx: *mut c_void,
    ) -> *mut c_void;

    /// Tears down an `MPNowPlayingSession` stream subscription.
    pub fn mp_now_playing_session_stream_unsubscribe(handle: *mut c_void);
}