暫無描述

Soomin Lee a0f2f3add5 build: cosmetic: indentation 7 年之前
.circleci 42a73a9fea Tests: Update CircleCI with macOS tests 7 年之前
Examples 66547b9312 Add tvOS example in Swift 7 年之前
Headers 970cc7ee79 VLCRendererItem, VLCRendererDiscoverer: remove _Nullable where not needed 7 年之前
MobileVLCKit.xcodeproj 53dfdb4b4e Tests: Add code coverage 7 年之前
Packaging 02bd38683d build and deploy: add support for macOS 7 年之前
Resources 3c56db161b patches: add patches to save dialog answers 7 年之前
Sources 45eff029ac VLCTime: Refactor verboseStringValue 7 年之前
Tests 832247dee9 Tests: Create macOS testing scheme 7 年之前
VLCKit.xcodeproj d5ce09bb82 Tests: Set macOS testing scheme to shared 7 年之前
doc 3ffddbd6a8 Update docs 7 年之前
.gitignore 97ee1afb81 Organize .gitignore 7 年之前
.mailmap a7a358e6a1 Update mailmap 7 年之前
CONTRIBUTING.md 5335668a8d Add contribution guide 9 年之前
COPYING fafb6def60 VLCKit: add proper licensing file 12 年之前
Gemfile 53dfdb4b4e Tests: Add code coverage 7 年之前
Gemfile.lock 53dfdb4b4e Tests: Add code coverage 7 年之前
Makefile dc8d8b6ee0 Add packaging script for VLCKit and MobileVLCKit (close #9099) 11 年之前
NEWS 7b1c411218 update News for 3.1.1. 7 年之前
README.md 332611b06d README: Remove trailing whitespace 7 年之前
Rakefile ef6520ecb6 Add rake tasks for macOS 7 年之前
compileAndBuildVLCKit.sh a0f2f3add5 build: cosmetic: indentation 7 年之前
documentation.html 09dc80cf40 Add symlink to make documentation accessible 9 年之前
doxygen.conf ceda117844 Add doxygen configuration 9 年之前

README.md

VLCKit

VLCKit is a generic multimedia library for any audio or video playback needs on macOS, iOS and tvOS.

It is based on libVLC, the engine of the popular media player VLC.

It supports playback, but also active streaming and media to file conversations on the Mac.

It is open-source software licensed under LGPLv2.1 or later, available in source code and binary form from the VideoLAN website.

You can also integrate VLCKit and its mobile version MobileVLCKit easily via CocoaPods.

Use-case

When do you need VLCKit? Frankly always when you need to play media not supported by QuickTime / AVFoundation or if you require more flexibility. You want to play something else besides H264/AAC files or HLS streams? You need subtitles beyond QuickTime’s basic support for Closed Captions? Your media source is not your mobile device and not a basic HTTP server either, but perhaps a live stream hailing from some weird media server or even a raw DVB signal broadcasted on a local network? Then, VLCKit is for you.

But this is open-source software right? What does this mean for me and the end-user? And wasn’t MobileVLC removed from the App Store in 2011 for some crazy licensing reason?

First of all, open-source means for you, that you get access to the whole stack. There is no blackbox, all the sources are there at your fingertips. No reverse-engineering needed, no private APIs.

Then again, this must not be the case for your software. The LGPLv2.1 allows our software to be included in proprietary apps, as long as you follow the license. As a start, make sure to publish any potential changes you do to our software, make sure that the end-user is aware that VLCKit is embedded within your greater work and that s/he is aware of the gained rights. S/he is granted access to our code as well as to your additions to our work. For further details, please read the license and consult your lawyer with any questions you might have.

Contribute!

As VLCKit is an open-source project hosted by VideoLAN, we happily welcome all kinds of contributions to it.

For detailed information on the development process, please read below and our wiki page on how to send patches.

Build

Run compileAndBuildVLCKit.sh with the -a ${ARCH} option

Build with your own VLC repository

  1. Put a vlc repository inside libvlc/vlc

    mkdir libvlc && cd libvlc && ln -s ${MYVLCGIT}

  2. Apply VLC patches needed for VLCKit

    cd vlc

    git am ../../Resources/MobileVLCKit/patches/*

  3. run compileAndBuildVLCKit.sh with the -n and the -a ${ARCH} option

Get in touch!

We happily provide guidance on VLCKit. The web forum is always there for you.

If you prefer live interaction, reach out to us via our IRC channel on the freenode Network (irc.freenode.org, #videolan). Use the Freenode Web interface, if you don't have an IRC client at hand.

Further reading

You can find more documentation on the VideoLAN wiki.