Quelle  VLCMediaSource.h   Sprache: C

/*****************************************************************************
 * VLCMediaSource.h: MacOS X interface module
 *****************************************************************************
 * Copyright (C) 2019 VLC authors and VideoLAN
 *
 * Authors: Felix Paul Kühne <fkuehne # videolan -dot- org>
 *
 * This program is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation; either version 2 of the License, or
 * (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program; if not, write to the Free Software
 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA.
 *****************************************************************************/

#import <Foundation/Foundation.h>

#import <vlc_media_source.h>
#import <vlc_preparser.h>

#import "VLCMediaSourceNodeObservation.h"

@class VLCInputItem;
@class VLCInputNode;

NS_ASSUME_NONNULL_BEGIN

extern NSString *VLCMediaSourceChildrenReset;
extern NSString *VLCMediaSourceChildrenAdded;
extern NSString *VLCMediaSourceChildrenRemoved;
extern NSString *VLCMediaSourcePreparsingStarted;
extern NSString *VLCMediaSourcePreparsingEnded;
extern NSString * const VLCMediaSourcePreparseInputItemKey;
extern NSString * const VLCMediaSourcePreparseStatusKey;

@interface VLCMediaSource : NSObject

- (instancetype)initForLocalDevices:(vlc_preparser_t *)p_preparser;
- (instancetype)initWithMediaSource:(vlc_media_source_t *)p_mediaSource
                  andPreparser:(vlc_preparser_t *)p_preparser
                        forCategory:(enum services_discovery_category_e)category;
- (instancetype)initMyFoldersMediaSourceWithPreparser:(vlc_preparser_t *)p_preparser;
- (instancetype)initWithFolderMrl:(NSString *)mrl
                     andPreparser:(vlc_preparser_t *)p_preparser;

- (nullable NSError *)preparseInputNodeWithinTree:(VLCInputNode *)inputNode;
/// Returns nil without an error when this media source cannot count children directly.
- (nullable NSNumber *)childCountForInputNode:(VLCInputNode *)inputNode
                                        error:(NSError * _Nullable * _Nullable)error;
- (void)clearChildNodesForNode:(input_item_node_t*)inputNode;
- (nullable NSError *)generateChildNodesForDirectoryNode:(VLCInputNode *)directoryInputNode
                                                 withUrl:(NSURL *)directoryUrl;
- (nullable id<VLCMediaSourceNodeObservation>)observeInputNode:(VLCInputNode *)inputNode
                                                      onChange:(void (^)(VLCMediaSourceNodeChange change))changeHandler;

@property (nonatomic, readonly) NSString *mediaSourceDescription;
@property (nonatomic, readonly) VLCInputNode *rootNode;
@property (nonatomic, readonly) enum services_discovery_category_e category;
@property (nonatomic, readonly) NSString *categoryDescription;
@property (readwrite) void (^willStartGeneratingChildNodesForNodeHandler)(input_item_node_t *);
@property (readwrite) void (^didFinishGeneratingChildNodesForNodeHandler)(input_item_node_t *);

@end

NS_ASSUME_NONNULL_END