iOS-lydstreaming med AVAssetResourceLoader

Anna Kosenko Co-Founder & Director at Everappz

Kort sagt: Brug AVAssetResourceLoaderDelegate med et brugerdefineret URL-skema til at opsnappe AVPlayers ressourceindlæsning. Dette giver dig mulighed for at tilføje brugerdefinerede autorisationsheadere til cloudtjenester, cache lyd til disk og styre streamingadfærd – alt sammen uden at skrive en lokal HTTP-proxy. Den fulde kildekode findes på GitHub.

Hvorfor AVPlayer har brug for en brugerdefineret ressourceindlæser

AVPlayer afspiller lyd fra lokale filer og fjern-URL’er. For de fleste cloudtjenester (Dropbox, Google Drive, Box) kan du angive en direkte download-URL, og afspilning virker ud af boksen.

Nogle tjenester som Yandex.Disk og WebDAV kræver dog brugerdefinerede autorisationsheadere i GET-anmodninger. AVPlayer har ingen indbygget måde at injicere disse headere på.

Løsningen: brug egenskaben resourceLoader på AVURLAsset. Denne API opsnapper ressourceindlæsningsanmodninger og fungerer som en lokal HTTP-proxy uden kompleksiteten.

Sådan fungerer det

AVPlayer bruger resourceLoader, når det ikke genkender URL-skemaet. Ved at erstatte https:// med et brugerdefineret skema (f.eks. customscheme://) tvinger du AVPlayer til at delegere al indlæsning til din app.

Du skal implementere to AVAssetResourceLoaderDelegate-metoder:

1. resourceLoader:shouldWaitForLoadingOfRequestedResource: – kaldes, når AVPlayer har brug for data. Gem AVAssetResourceLoadingRequest og start din dataindlæsningsoperation.
2. resourceLoader:didCancelLoadingRequest: – kaldes, når en anmodning annulleres eller erstattes.

Sådan opretter du en brugerdefineret AVPlayer

Opsæt en AVPlayer med et brugerdefineret URL-skema:

NSURL *url = [NSURL URLWithString:@"customscheme://host/audio.mp3"];
AVURLAsset *asset = [AVURLAsset URLAssetWithURL:url options:nil];
[asset.resourceLoader setDelegate:self queue:dispatch_get_main_queue()];
AVPlayerItem *item = [AVPlayerItem playerItemWithAsset:asset];
[self addObserversForPlayerItem:item];
self.player = [AVPlayer playerWithPlayerItem:item];
[self addObserversForPlayer];

Denne kode:

• Definerer en URL med dit brugerdefinerede skema
• Opretter en AVURLAsset med en delegat på hovedkøen
• Bygger et AVPlayerItem fra asset’et
• Initialiserer AVPlayer

Implementering af ressourceindlæser-delegaten

Opret en klasse kaldet LSFilePlayerResourceLoader til at håndtere datahentning fra serveren og sende den tilbage til AVURLAsset. Gem indlæserforekomster i en ordbog, der er nøglet af ressource-URL’en.

- (BOOL)resourceLoader:(AVAssetResourceLoader *)resourceLoader shouldWaitForLoadingOfRequestedResource:(AVAssetResourceLoadingRequest *)loadingRequest {
    NSURL *resourceURL = [loadingRequest.request URL];
    if ([resourceURL.scheme isEqualToString:@"customscheme"]) {
        LSFilePlayerResourceLoader *loader = 
        [self resourceLoaderForRequest:loadingRequest];
        if (!loader) {
            loader = [[LSFilePlayerResourceLoader alloc] initWithResourceURL:resourceURL session:self.session];
            loader.delegate = self;
            [self.resourceLoaders setObject:loader forKey:[self keyForResourceLoaderWithURL:resourceURL]];
        }
        [loader addRequest:loadingRequest];
        return YES;
    }
    return NO;
}

- (void)resourceLoader:(AVAssetResourceLoader *)resourceLoader didCancelLoadingRequest:(AVAssetResourceLoadingRequest *)loadingRequest {
    LSFilePlayerResourceLoader *loader = [self resourceLoaderForRequest:loadingRequest];
    [loader removeRequest:loadingRequest];
}

Disse metoder kontrollerer URL-skemaet, opretter eller henter en indlæser og tilføjer anmodningen til indlæserens kø. Ukendte skemaer returnerer NO.

LSFilePlayerResourceLoader-interface

@interface LSFilePlayerResourceLoader : NSObject

@property (nonatomic, readonly, strong) NSURL *resourceURL;
@property (nonatomic, readonly) NSArray *requests;
@property (nonatomic, readonly, strong) YDSession *session;
@property (nonatomic, readonly, assign) BOOL isCancelled;
@property (nonatomic, weak) id<LSFilePlayerResourceLoaderDelegate> delegate;

- (instancetype)initWithResourceURL:(NSURL *)url session:(YDSession *)session;
- (void)addRequest:(AVAssetResourceLoadingRequest *)loadingRequest;
- (void)removeRequest:(AVAssetResourceLoadingRequest *)loadingRequest;
- (void)cancel;

@end

@protocol LSFilePlayerResourceLoaderDelegate <NSObject>

@optional
- (void)filePlayerResourceLoader:(LSFilePlayerResourceLoader *)resourceLoader didFailWithError:(NSError *)error;
- (void)filePlayerResourceLoader:(LSFilePlayerResourceLoader *)resourceLoader didLoadResource:(NSURL *)resourceURL;

@end

Dataindlæsning: to-trinsproces

Når en indlæsningsanmodning kommer i køen, udføres to operationer i rækkefølge:

• contentInfoOperation – forespørger indholdslængde, MIME-type og understøttelse af byte-range
• dataOperation – henter fildata startende fra requestedOffset

Diskcaching-strategi

Downloadede data skrives til en midlertidig fil på disk. Efterfølgende anmodninger om det samme indhold betjenes fra denne cache, hvilket undgår overflødige netværkskald. Denne tilgang:

• Reducerer båndbreddeforbrug
• Muliggør næsten øjeblikkelig genafspilning
• Understøtter søgeoperationer inden for cachede intervaller

Behandling af ventende anmodninger

Metoden processPendingRequests udfylder contentInformationRequest for hver anmodning med metadata og leverer cachede byte-intervaller. Færdige anmodninger fjernes fra køen.

Kildekode og næste skridt

Denne vejledning giver et overordnet overblik over implementering af AVAssetResourceLoaderDelegate til cloud-lydstreaming med brugerdefinerede autorisationsheadere. Den fulde kildekode er tilgængelig på GitHub.

Denne tilgang driver lydstreaming-motoren i Evermusic, som streamer musik fra Dropbox, Google Drive, OneDrive, Yandex.Disk og andre cloudtjenester på iOS og macOS.

Ofte stillede spørgsmål