NEWS 8 KB
Newer Older
1 2
Version 3.0.0:
--------------
3 4 5
Generic changes:
- Added support for tvOS
- Removed support for the 32bit OS X platform
6
- Added support for audio muting and software volume changes on iOS and tvOS
7

8
New APIs:
9 10 11 12 13 14
- VLCAudio
  - setMuted:

- VLCDialogProvider
  - new class to handle user interaction with VLC events

15 16 17
- VLCLibrary
  - added properties: debugLogging, debugLoggingLevel

18 19 20 21 22 23 24
- VLCMediaDiscoverer
  - added selector: availableMediaDiscovererForCategoryType:
  - added enum: VLCMediaDiscovererCategoryType

- VLCMediaListPlayer
  - added selectors: initWithDrawable:
                     initWithOptions:andDrawable:
25
                     playItemAtNumber:
26

27
- VLCMediaPlayer
Felix Paul Kühne's avatar
Felix Paul Kühne committed
28 29
  - added properties: titleDescriptions, indexOfLongestTitle, numberOfTitles,
                      snapshots, lastSnapshot
30 31
  - added selectors: chaptersForTitleIndex:
                     numberOfChaptersForTitle:
32
                     addPlaybackSlave:type:enforce:
Felix Paul Kühne's avatar
Felix Paul Kühne committed
33
                     updateViewpoint:pitch:roll:fov:absolute:
34
  - added notifications: VLCMediaPlayerTitleChanged, VLCMediaPlayerChapterChanged
35
  - added enum: VLCMediaPlaybackSlaveType
36 37 38
  - Note:
    - play's return type was changed from BOOL to void
    - hue is now a float instead of an integer
39 40 41 42 43 44 45 46
  - WARNING:
    - Return value of the following methods changed from INT_MAX to -1
      (int)currentVideoTrackIndex
      (int)currentVideoSubTitleIndex
      (int)currentChapterIndex
      (int)currentTitleIndex
      (int)currentAudioTrackIndex

47 48 49 50
- VLCMedia
  - added keys: VLCMetaInformationTrackTotal, VLCMetaInformationDirector,
                VLCMetaInformationSeason, VLCMetaInformationEpisode,
                VLCMetaInformationShowName, VLCMetaInformationActors,
Felix Paul Kühne's avatar
Felix Paul Kühne committed
51 52 53
                VLCMetaInformationAlbumArtist, VLCMetaInformationDiscNumber,
                VLCMediaTracksInformationVideoOrientation,
                VLCMediaTracksInformationVideoProjection
54 55
  - added selectors: codecNameForFourCC:trackType:
                     mediaType
56
                     parseWithOptions:
57 58
                     parseWithOptions:Timeout:
                     parsedStatus
59 60
                     storeCookie:forHost:path:
                     clearStoredCookies
Felix Paul Kühne's avatar
Felix Paul Kühne committed
61 62
  - added enums: VLCMediaType, VLCMediaParsingOptions, VLCMediaParsedStatus,
                 VLCMediaOrientation, VLCMediaProjection
63 64
  - changed behavior: media will no longer be parsed automatically if meta
      data is requested prior to concluded parsing
65

66 67 68 69
- VLCMediaList
  - changed behavior: lists of media objects added through arrays or on init
      are no longer added in reverse order

70 71 72 73
- VLCTime
  - added selectors: isEqual:
                     hash

74 75 76
- VLCAudio
  - added property: passthrough

77 78 79 80 81 82 83 84 85 86
Modified APIs:
- VLCMediaList
  - To match the KVC bindings, all NSInteger arguments were moved to NSUInteger as appropriate
      - mediaList:mediaAdded:atIndex:
      - mediaList:mediaRemovedAtIndex:
      - addMedia:
      - insertMedia:atIndex:
      - removeMediaAtIndex:
      - mediaAtIndex:

87
Deprecated APIs:
88 89
- VLCAudio
  - setMute:
90
- VLCMedia
91
  - parse, isParsed, synchronousParse
92
- VLCMediaDiscoverer
93
  - availableMediaDiscoverer, localizedName
94
- VLCMediaPlayer
95
  - titles, chaptersForTitleIndex:, countOfTitles, framesPerSecond, openVideoSubTitlesFromFile:
96 97
- VLCMediaListPlayer
  - playItemAtIndex
98 99 100
- VLCStreamSession
- VLCStreamOutput
- VLCMediaLibrary
101

102
Removed APIs:
103 104
- VLCExtension
- VLCExtensionsManager
105 106 107 108 109 110 111
- VLCMedia:
  - fps
  - media:metaValueChangedFrom:forKey:
- VLCMediaPlayer
  - audioTracks
  - videoTracks
  - videoSubTitles
112
- VLCServicesDiscoverer
113
- VLCPlaylistDataSource
114

115 116 117 118 119 120 121
Version 2.2.2:
--------------
New APIs:
- VLCMediaPlayer
  - added properties: numberOfVideoTracks, numberOfSubtitlesTracks
    numberOfAudioTracks

122 123
Version 2.2.0:
--------------
124

Felix Paul Kühne's avatar
Felix Paul Kühne committed
125 126 127
Cross-platform:
- Fixed deinterlacing if requested
- Fixed decoding and display of Teletext-based subtitles
128
- Improved thumbnailing reliability
Felix Paul Kühne's avatar
Felix Paul Kühne committed
129 130 131
- Added support for inclusion in swift projects
- Switched to Automatic Reference Counting
- Various stability improvements
Felix Paul Kühne's avatar
Felix Paul Kühne committed
132 133 134 135 136 137

MobileVLCKit:
- It is finally possible to compile the framework without relying on third
  party scripts
- Added 2 sample projects illustrating video playback
- Added support for https and hls playback
138
- VLCMediaListPlayer is available now
139
- Added support for https connectivity
Felix Paul Kühne's avatar
Felix Paul Kühne committed
140

141 142 143
VLCKit:
- VLCMediaThumbnailer is a public API on the Mac now matching the mobile
  counterpart
Felix Paul Kühne's avatar
Felix Paul Kühne committed
144
- Updated samples projects illustrating playback, file conversation, ...
145

Felix Paul Kühne's avatar
Felix Paul Kühne committed
146 147 148
New APIs:
- VLCMediaThumbnailer:
  - added property: snapshotPosition to overwrite the default
149 150
- VLCMediaListPlayer:
  - added initWithOptions selector matching VLCMediaPlayer's implementation
151
  - added pause selector
152
  - added previous, next and playItemAtIndex selectors
153 154
- VLCMedia:
  - added delegate method mediaMetaDataDidChange
155 156
- VLCMediaPlayer:
  - added equalizer
157
  - added countOfTitles
Felix Paul Kühne's avatar
Felix Paul Kühne committed
158

159 160
Modified API behavior:
- VLCMediaPlayer:
161 162
  - implementing mediaPlayerTimeChanged and mediaPlayerStateChanged within a
    delegate object is optional now
163 164
- VLCMedia:
  - nowPlaying meta information is correctly handled now
165

166 167 168
Deprecated APIs:
- VLCMedia:
  - media:metaValueChangedFrom:forKey:
169

170 171 172 173 174 175
Changes within VLCKit between 2.0.0 and 2.1.0:
----------------------------------------------
The entire framework was relicensed to LGPL 2.1 or later as well as its
underlying playback modules.
Support for transcoding and streaming as well as DVD playback was not affected
by this move and stays under GPL until further notice.
Felix Paul Kühne's avatar
Felix Paul Kühne committed
176 177
Please note that the Objective-C syntax was updated, so VLCKit may no longer
compile with outdated versions of Xcode / clang.
178 179 180 181 182 183 184 185

New APIs:
- VLCStreamOutput:
  - support for subtitle transcoding
- VLCMedia:
  - extended media track information for bitrate, language, description, source
    aspect ratio, source aspect denominator, frame rate, frame rate denominator,
    and text encoding
Felix Paul Kühne's avatar
Felix Paul Kühne committed
186 187
  - added setter and getter for individual meta data values as well as the
    ability to write changes to the media file
188 189 190
  - added (BOOL)isMediaSizeSuitableForDevice to let VLCKit determine whether the
    current media is considered to be suitable for the current device or
    playback is discouraged. Will always return true on OS X devices.
191 192 193
  - added individual getters for all statistic values, so client application can
    fetch single values instead of having to process a NSDictionary with all the
    available values. The old API is still available and will stay.
194 195 196 197 198 199 200
- VLCMediaPlayer:
  - added support to enable, switch and disable video tracks
  - added setter/getter for SPU and audio delays
  - added setter/getter for the video scale factor
  - added support for the "adjust" video filter to manipulate contrast,
    brightness, hue, saturation and gamma on the fly
  - new interfaces to fetch names and IDs of audio, subtitle and video tracks
Felix Paul Kühne's avatar
Felix Paul Kühne committed
201 202 203
  - added the ability to launch instances with custom libvlc options
- VLCLibrary:
  - added the ability to launch instances with custom libvlc options
Felix Paul Kühne's avatar
Felix Paul Kühne committed
204 205
  - added methods to set App ID and User-Agent
  - added readonly property to fetch compiler information
206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229

Deprecated APIs:
- VLCMediaPlayer:
  @property (readonly) NSUInteger fps;
    - use (float)fps instead.
  - (NSArray *)videoSubTitles;
    - use - (NSArray *)videoSubtitleNames; instead
  - (NSArray *)audioTracks;
    - use - (NSArray *)audioTrackNames; instead
  - (NSArray *)videoTracks;
    - use - (NSArray *)videoTrackNames; instead

Modified behavior:
- use of clang instead of llvm-gcc-4.2
- updated project file for Xcode 4.3 and later
- iOS Deployment target was raised to iOS 5.1
- dropped support for the PowerPC architecture
- Mac Deployment target was raised to OS X 10.7
- different logging behavior: to see any debug messages, the framework needs
  to be compiled in debug mode

MobileVLCKit features:
- added support for Opus
- slimmed binary by removing dysfunctional or irrelevant modules
Felix Paul Kühne's avatar
Felix Paul Kühne committed
230 231
- screen sleep is prevented during playback
- functionality is strictly limited for full LGPL compliance
232 233 234 235

Removed APIs:
- VLCMedia:
  - (void)setValue:(id)value forMeta:(NSString *)VLCMetaInformation;
Felix Paul Kühne's avatar
Felix Paul Kühne committed
236
    use setMetadata:(NSString *)data forKey:(NSString *)key instead