forked from Blendman974/faceclaw
42 lines
1.9 KiB
Objective-C
42 lines
1.9 KiB
Objective-C
#import <Foundation/Foundation.h>
|
|
|
|
/**
|
|
* Apple Music (the system Music app) through the MediaPlayer framework: now-playing state
|
|
* and transport on the system player, the media library as a browse tree, and the system
|
|
* output volume. Call from the main thread; callbacks are delivered on the main queue.
|
|
* Nothing touches the player or library until media-library access is granted, so no
|
|
* permission prompt appears unasked.
|
|
*/
|
|
@interface FaceclawAppleMusic : NSObject
|
|
+ (instancetype)shared;
|
|
/** Playback state, the now-playing item or authorization may have changed. */
|
|
@property(nonatomic, copy) void (^changeHandler)(void);
|
|
- (BOOL)hasPermission;
|
|
- (NSString *)permissionStatus;
|
|
- (void)requestPermission:(void (^)(BOOL granted))completion;
|
|
/** Observe the system player (and keep observing across authorization changes). */
|
|
- (void)start;
|
|
- (void)stop;
|
|
/** The system player as a JSON object; {"access": false} until access is granted. */
|
|
- (NSString *)stateJson;
|
|
- (void)playPause;
|
|
- (void)skipNext;
|
|
- (void)skipPrevious;
|
|
/**
|
|
* The queue Faceclaw last started, as [{"id", "title", "active"}], while the player is
|
|
* still playing from it; "[]" otherwise (the system player does not expose queues that
|
|
* the Music app started).
|
|
*/
|
|
- (NSString *)queueJson;
|
|
- (void)skipToQueueIndex:(NSInteger)index;
|
|
/** [widthLo, widthHi, heightLo, heightHi, BGRA...] fitted within maxSize (never upscaled), or nil. */
|
|
- (NSData *)albumArt:(NSInteger)maxSize;
|
|
/** System output volume 0..100, or -1 when unknown. */
|
|
- (double)volumePercent;
|
|
- (void)setVolumePercent:(double)percent;
|
|
/** One level of the library tree ("root" first) as [{"mediaId", "title", "subtitle", "browsable", "playable"}]. */
|
|
- (void)browse:(NSString *)parentId completion:(void (^)(NSString *json, NSString *error))completion;
|
|
/** Start playback of a browsed collection, or of a song within its collection. */
|
|
- (void)play:(NSString *)mediaId completion:(void (^)(NSString *error))completion;
|
|
@end
|