瀏覽代碼

Deprecate VLCExtension, VLCExtensionManager, VLCMediaLibrary, VLCStreamOutput, VLCStreamSession as all of those were not maintained or further developed since 2009

Felix Paul Kühne 9 年之前
父節點
當前提交
83aba34c83

+ 8 - 4
Headers/Public/VLCExtension.h

@@ -31,22 +31,26 @@
 /**
  * initializer for wrapper class
  * \param instance the extension_t instance to init the wrapper with
+ * \deprecated will be removed in the next release
  */
-- (instancetype)initWithInstance:(struct extension_t *)instance NS_DESIGNATED_INITIALIZER; // FIXME: Should be internal
+- (instancetype)initWithInstance:(struct extension_t *)instance NS_DESIGNATED_INITIALIZER __attribute__((deprecated)); // FIXME: Should be internal
 
 /**
  * the extension instance used to init the wrapper with
+ * \deprecated will be removed in the next release
  */
-@property (NS_NONATOMIC_IOSONLY, readonly) struct extension_t *instance; // FIXME: Should be internal
+@property (NS_NONATOMIC_IOSONLY, readonly) struct extension_t *instance __attribute__((deprecated)); // FIXME: Should be internal
 
 /**
  * technical name of the extension
+ * \deprecated will be removed in the next release
  */
-@property (NS_NONATOMIC_IOSONLY, readonly, copy) NSString *name;
+@property (NS_NONATOMIC_IOSONLY, readonly, copy) NSString *name __attribute__((deprecated));
 
 /**
  * user-visible name of the extension
+ * \deprecated will be removed in the next release
  */
-@property (NS_NONATOMIC_IOSONLY, readonly, copy) NSString *title;
+@property (NS_NONATOMIC_IOSONLY, readonly, copy) NSString *title __attribute__((deprecated));
 
 @end

+ 8 - 4
Headers/Public/VLCExtensionsManager.h

@@ -32,23 +32,27 @@
 
 /**
  * singleton manager instance
+ * \deprecated will be removed in the next release
  */
-+ (VLCExtensionsManager *)sharedManager;
++ (VLCExtensionsManager *)sharedManager __attribute__((deprecated));
 
 /**
  * list of available extensions
+ * \deprecated will be removed in the next release
  */
-@property (NS_NONATOMIC_IOSONLY, readonly, copy) NSArray *extensions;
+@property (NS_NONATOMIC_IOSONLY, readonly, copy) NSArray *extensions __attribute__((deprecated));
 
 /**
  * start execution of a given extension instance
  * \param extension the extension to run
+ * \deprecated will be removed in the next release
  */
-- (void)runExtension:(VLCExtension *)extension;
+- (void)runExtension:(VLCExtension *)extension __attribute__((deprecated));
 
 /**
  * player instance to use with the extensions
+ * \deprecated will be removed in the next release
  */
-@property (readwrite, strong) VLCMediaPlayer *mediaPlayer;
+@property (readwrite, strong) VLCMediaPlayer *mediaPlayer __attribute__((deprecated));
 
 @end

+ 5 - 3
Headers/Public/VLCMediaLibrary.h

@@ -32,13 +32,15 @@
 @interface VLCMediaLibrary : NSObject
 
 /**
-* library singleton
+ * library singleton
+ * \deprecated will be removed in the next release
 */
-+ (VLCMediaLibrary*)sharedMediaLibrary;
++ (VLCMediaLibrary*)sharedMediaLibrary __attribute__((deprecated));
 
 /**
  * list of all media
+ * \deprecated will be removed in the next release
  */
-@property (nonatomic, readonly, strong) VLCMediaList * allMedia;
+@property (nonatomic, readonly, strong) VLCMediaList * allMedia __attribute__((deprecated));
 
 @end

+ 41 - 8
Headers/Public/VLCStreamOutput.h

@@ -22,8 +22,17 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA.
  *****************************************************************************/
 
+/**
+ * \deprecated will be removed in the next release
+ */
 extern NSString * VLCDefaultStreamOutputRTSP;
+/**
+ * \deprecated will be removed in the next release
+ */
 extern NSString * VLCDefaultStreamOutputRTP;
+/**
+ * \deprecated will be removed in the next release
+ */
 extern NSString * VLCDefaultStreamOutputRTP;
 
 /**
@@ -31,14 +40,38 @@ extern NSString * VLCDefaultStreamOutputRTP;
  */
 @interface VLCStreamOutput : NSObject
 
-- (instancetype)initWithOptionDictionary:(NSDictionary *)dictionary NS_DESIGNATED_INITIALIZER;
-+ (instancetype)streamOutputWithOptionDictionary:(NSDictionary *)dictionary;
+/**
+ * \deprecated will be removed in the next release
+ */
+- (instancetype)initWithOptionDictionary:(NSDictionary *)dictionary NS_DESIGNATED_INITIALIZER __attribute__((deprecated));
+/**
+ * \deprecated will be removed in the next release
+ */
++ (instancetype)streamOutputWithOptionDictionary:(NSDictionary *)dictionary __attribute__((deprecated));
 
-+ (id)rtpBroadcastStreamOutputWithSAPAnnounce:(NSString *)announceName;
-+ (id)rtpBroadcastStreamOutput;
-+ (id)ipodStreamOutputWithFilePath:(NSString *)filePath;
-+ (instancetype)streamOutputWithFilePath:(NSString *)filePath;
-+ (id)mpeg2StreamOutputWithFilePath:(NSString *)filePath;
-+ (id)mpeg4StreamOutputWithFilePath:(NSString *)filePath;
+/**
+ * \deprecated will be removed in the next release
+ */
++ (id)rtpBroadcastStreamOutputWithSAPAnnounce:(NSString *)announceName __attribute__((deprecated));
+/**
+ * \deprecated will be removed in the next release
+ */
++ (id)rtpBroadcastStreamOutput __attribute__((deprecated));
+/**
+ * \deprecated will be removed in the next release
+ */
++ (id)ipodStreamOutputWithFilePath:(NSString *)filePath __attribute__((deprecated));
+/**
+ * \deprecated will be removed in the next release
+ */
++ (instancetype)streamOutputWithFilePath:(NSString *)filePath __attribute__((deprecated));
+/**
+ * \deprecated will be removed in the next release
+ */
++ (id)mpeg2StreamOutputWithFilePath:(NSString *)filePath __attribute__((deprecated));
+/**
+ * \deprecated will be removed in the next release
+ */
++ (id)mpeg4StreamOutputWithFilePath:(NSString *)filePath __attribute__((deprecated));
 
 @end

+ 24 - 6
Headers/Public/VLCStreamSession.h

@@ -31,13 +31,31 @@
  */
 @interface VLCStreamSession : VLCMediaPlayer
 
-+ (instancetype)streamSession;
+/**
+ * \deprecated will be removed in the next release
+ */
++ (instancetype)streamSession __attribute__((deprecated));
 
-@property (nonatomic, strong) VLCStreamOutput * streamOutput;
-@property (nonatomic, readonly) BOOL isComplete;
-@property (nonatomic, readonly) NSUInteger reattemptedConnections;
+/**
+ * \deprecated will be removed in the next release
+ */
+@property (nonatomic, strong) VLCStreamOutput * streamOutput __attribute__((deprecated));
+/**
+ * \deprecated will be removed in the next release
+ */
+@property (nonatomic, readonly) BOOL isComplete __attribute__((deprecated));
+/**
+ * \deprecated will be removed in the next release
+ */
+@property (nonatomic, readonly) NSUInteger reattemptedConnections __attribute__((deprecated));
 
-- (void)startStreaming;
-- (void)stopStreaming;
+/**
+ * \deprecated will be removed in the next release
+ */
+- (void)startStreaming __attribute__((deprecated));
+/**
+ * \deprecated will be removed in the next release
+ */
+- (void)stopStreaming __attribute__((deprecated));
 
 @end

+ 6 - 0
NEWS

@@ -65,6 +65,11 @@ Deprecated APIs:
   - titles, chaptersForTitleIndex:, countOfTitles, framesPerSecond, openVideoSubTitlesFromFile:
 - VLCMediaListPlayer
   - playItemAtIndex
+- VLCExtension
+- VLCExtensionsManager
+- VLCStreamSession
+- VLCStreamOutput
+- VLCMediaLibrary
 
 Removed APIs:
 - VLCMedia:
@@ -74,6 +79,7 @@ Removed APIs:
   - audioTracks
   - videoTracks
   - videoSubTitles
+- VLCServicesDiscoverer
 
 Version 2.2.2:
 --------------