Phát trực tuyến âm thanh iOS với AVAssetResourceLoader

Anna Kosenko Co-Founder & Director at Everappz

TL;DR: Sử dụng AVAssetResourceLoaderDelegate với URL scheme tùy chỉnh để chặn việc tải tài nguyên của AVPlayer. Điều này cho phép bạn thêm header ủy quyền tùy chỉnh cho các dịch vụ đám mây, lưu bộ nhớ đệm âm thanh vào đĩa và kiểm soát hành vi phát trực tuyến – tất cả mà không cần viết một proxy HTTP cục bộ. Mã nguồn đầy đủ có trên GitHub.

Tại sao AVPlayer cần bộ tải tài nguyên tùy chỉnh

AVPlayer phát âm thanh từ tệp cục bộ và URL từ xa. Đối với hầu hết các dịch vụ đám mây (Dropbox, Google Drive, Box), bạn có thể truyền URL tải xuống trực tiếp và phát lại hoạt động ngay lập tức.

Tuy nhiên, một số dịch vụ như Yandex.Disk và WebDAV yêu cầu header ủy quyền tùy chỉnh trong các yêu cầu GET. AVPlayer không cung cấp cách tích hợp sẵn để chèn các header này.

Giải pháp: sử dụng thuộc tính resourceLoader của AVURLAsset. API này chặn các yêu cầu tải tài nguyên, hoạt động như một proxy HTTP cục bộ mà không có sự phức tạp.

Cách hoạt động

AVPlayer sử dụng resourceLoader khi không nhận ra URL scheme. Bằng cách thay https:// bằng scheme tùy chỉnh (ví dụ: customscheme://), bạn buộc AVPlayer ủy quyền toàn bộ việc tải cho ứng dụng của mình.

Bạn cần triển khai hai phương thức AVAssetResourceLoaderDelegate:

1. resourceLoader:shouldWaitForLoadingOfRequestedResource: – được gọi khi AVPlayer cần dữ liệu. Lưu AVAssetResourceLoadingRequest và bắt đầu thao tác tải dữ liệu.
2. resourceLoader:didCancelLoadingRequest: – được gọi khi một yêu cầu bị hủy hoặc được thay thế.

Cách tạo AVPlayer tùy chỉnh

Thiết lập AVPlayer với URL scheme tùy chỉnh:

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];

Đoạn mã này:

• Định nghĩa URL với scheme tùy chỉnh
• Tạo AVURLAsset với delegate trên hàng đợi chính
• Xây dựng AVPlayerItem từ asset
• Khởi tạo AVPlayer

Triển khai delegate của bộ tải tài nguyên

Tạo lớp LSFilePlayerResourceLoader để xử lý việc tải dữ liệu từ máy chủ và truyền lại cho AVURLAsset. Lưu các thể hiện của bộ tải trong từ điển được khóa theo URL tài nguyên.

- (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];
}

Các phương thức này kiểm tra URL scheme, tạo hoặc lấy bộ tải, và thêm yêu cầu vào hàng đợi. Các scheme không được nhận dạng trả về NO.

Giao diện LSFilePlayerResourceLoader

@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

Tải dữ liệu: Quy trình hai bước

Khi một yêu cầu tải vào hàng đợi, hai thao tác được thực hiện tuần tự:

• contentInfoOperation – truy vấn độ dài nội dung, loại MIME và hỗ trợ byte-range
• dataOperation – lấy dữ liệu tệp bắt đầu từ requestedOffset

Chiến lược lưu bộ nhớ đệm đĩa

Dữ liệu đã tải được ghi vào tệp tạm thời trên đĩa. Các yêu cầu tiếp theo cho cùng nội dung được phục vụ từ bộ nhớ đệm này, tránh các lần gọi mạng dư thừa. Cách tiếp cận này:

• Giảm mức sử dụng băng thông
• Cho phép phát lại gần như tức thì
• Hỗ trợ thao tác tua trong các phạm vi đã lưu bộ nhớ đệm

Xử lý các yêu cầu đang chờ

Phương thức processPendingRequests điền contentInformationRequest của mỗi yêu cầu với siêu dữ liệu và phân phối các phạm vi byte đã lưu bộ nhớ đệm. Các yêu cầu đã hoàn thành được xóa khỏi hàng đợi.

Mã nguồn và các bước tiếp theo

Hướng dẫn này cung cấp tổng quan về việc triển khai AVAssetResourceLoaderDelegate để phát trực tuyến âm thanh đám mây với header ủy quyền tùy chỉnh. Mã nguồn đầy đủ có trên GitHub.

Phương pháp này hỗ trợ engine phát trực tuyến âm thanh trong Evermusic, ứng dụng phát nhạc từ Dropbox, Google Drive, OneDrive, Yandex.Disk và các dịch vụ đám mây khác trên iOS và macOS.

Câu hỏi thường gặp