Shaka Player Embedded
|
Shaka Player Embedded is a framework that runs Shaka Player in native (C++) apps. This gives a cross-platform interface to Shaka Player allowing native apps to use the player. Your native apps can now be built with the same features, behavior, and API as your Shaka-based web apps.
In addition to the C++ API, we provide a high-level wrapper for iOS called ShakaPlayerView which can be used from either Objective-C or Swift.
See our documentation and iOS tutorial.
We only support iOS at this time, but other platforms could be added.
Because many on our team use Linux, there is a Linux port included to make it easier to work on non-iOS-specific features. Linux is not, however, a first-class target platform at this time.
This project is currently in an open beta. We would love to have your feedback on what we've built, but we are not yet feature-complete for v1.0. As such, ABI compatibility is not yet guaranteed.
If you are interested in release and survey announcements, please join our mailing list: https://groups.google.com/forum/#!forum/shaka-player-users
This is a very low-volume list that only admins of the project may post to.
For issues or to start a discussion, please use github issues: https://github.com/google/shaka-player-embedded/issues
Widevine support requires the Widevine CDM for iOS, which must be obtained separately from Widevine, under license. The Widevine CDM is not open-source.
We don't have an exact release date yet, but the Widevine CDM for iOS should be available by the time we tag v1.0 of Shaka Player Embedded.
enum34
This does not require a C++ compiler as it uses a pre-compiled version of clang downloaded from Google Cloud Storage. However, it does require a C++11 compatible C++ library (installed with most compilers, e.g. gcc).
We use git submodules to manage third-party dependencies. You can run git submodule update
(or pass --recurse-submodules
to git clone
) to download all the submodules; or you can wait and have the configure
script download only those you need.
You need to run configure
to setup configuration settings. You can pass –help to see some of the options you can use. We don't support in-tree builds; you need to run configure
in another directory.
Once configure
is done, you can build using build.py
. There is a Makefile that will run the script for you if you prefer.
Once it is built, you can use the resulting shared library.
On iOS, there will be a ShakaPlayerEmbedded.framework
folder that you use; there is also a ShakaPlayerEmbedded.FFmpeg.framework
bundle that you need to include in your app, but you shouldn't use it directly since we don't maintain ABI for it.
On other platforms, there is a libshaka-player-embedded.dylib
or a libshaka-player-embedded.so
file you can use. Like iOS, there is a libshaka-player-embedded.ffmpeg.*
file you need to include too.
If you are using a custom --eme-impl
, you need to copy the respective shared libraries too, if needed.
If you intend to send a pull-request, you need to ensure the code complies with style guidelines. This is done with the shaka/tools/presubmit.py
script, which can be run with make check
.
To run all the checks, you also have to have clang-tidy
installed. It needs to be installed on PATH
, or you can pass --clang-tidy
to the script to tell it where to find the binary.