NEWS 7.84 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
Felix Paul Kühne's avatar
Felix Paul Kühne committed
6
- Added support for audio muting 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
- VLCTime
  - added selectors: isEqual:
                     hash

70 71 72
- VLCAudio
  - added property: passthrough

73 74 75 76 77 78 79 80 81 82
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:

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

98
Removed APIs:
99 100
- VLCExtension
- VLCExtensionsManager
101 102 103 104 105 106 107
- VLCMedia:
  - fps
  - media:metaValueChangedFrom:forKey:
- VLCMediaPlayer
  - audioTracks
  - videoTracks
  - videoSubTitles
108
- VLCServicesDiscoverer
109
- VLCPlaylistDataSource
110

111 112 113 114 115 116 117
Version 2.2.2:
--------------
New APIs:
- VLCMediaPlayer
  - added properties: numberOfVideoTracks, numberOfSubtitlesTracks
    numberOfAudioTracks

118 119
Version 2.2.0:
--------------
120

Felix Paul Kühne's avatar
Felix Paul Kühne committed
121 122 123
Cross-platform:
- Fixed deinterlacing if requested
- Fixed decoding and display of Teletext-based subtitles
124
- Improved thumbnailing reliability
Felix Paul Kühne's avatar
Felix Paul Kühne committed
125 126 127
- 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
128 129 130 131 132 133

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
134
- VLCMediaListPlayer is available now
135
- Added support for https connectivity
Felix Paul Kühne's avatar
Felix Paul Kühne committed
136

137 138 139
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
140
- Updated samples projects illustrating playback, file conversation, ...
141

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

155 156
Modified API behavior:
- VLCMediaPlayer:
157 158
  - implementing mediaPlayerTimeChanged and mediaPlayerStateChanged within a
    delegate object is optional now
159 160
- VLCMedia:
  - nowPlaying meta information is correctly handled now
161

162 163 164
Deprecated APIs:
- VLCMedia:
  - media:metaValueChangedFrom:forKey:
165

166 167 168 169 170 171
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
172 173
Please note that the Objective-C syntax was updated, so VLCKit may no longer
compile with outdated versions of Xcode / clang.
174 175 176 177 178 179 180 181

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
182 183
  - added setter and getter for individual meta data values as well as the
    ability to write changes to the media file
184 185 186
  - 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.
187 188 189
  - 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.
190 191 192 193 194 195 196
- 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
197 198 199
  - 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
200 201
  - added methods to set App ID and User-Agent
  - added readonly property to fetch compiler information
202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225

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
226 227
- screen sleep is prevented during playback
- functionality is strictly limited for full LGPL compliance
228 229 230 231

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