Need help with clappr-ios?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

clappr
113 Stars 31 Forks BSD 3-Clause "New" or "Revised" License 3.2K Commits 1 Opened issues

Description

An extensible media player for iOS.

Services available

!
?

Need anything else?

Contributors list

DEPRECATED

⛔️ This project is no longer supported.

Clappr for iOS and tvOS

image

Clappr is an extensible media player for iOS and tvOS.

Installation

CocoaPods

CocoaPods is a dependency manager for Cocoa projects. You can install it with the following command:

$ gem install cocoapods

To integrate Clappr into your Xcode project using CocoaPods, specify it to a target in your

Podfile
:
source 'https://github.com/CocoaPods/Specs.git'
platform :ios, '8.0'
use_frameworks!

target '' do pod 'Clappr', '~> 0.9.0' end

Then, run the following command:

$ pod install

Carthage

Carthage is a decentralized dependency manager that builds your dependencies and provides you with binary frameworks.

You can install Carthage with Homebrew using the following command:

$ brew update
$ brew install carthage

To integrate Clappr into your Xcode project using Carthage, specify it in your

Cartfile
:
github "clappr/clappr-ios"  ~> 0.9.0

Run

carthage update
to build the framework and drag the built
Clappr.framework
into your Xcode project.

Usage

iOS

Create

let options = [kSourceUrl : "http://clappr.io/highline.mp4"]
let player = Player(options: options)

Add it in your view

player.attachTo(yourView, controller: self)

Media Control

It's a built-in plugin (i.e..: it can be replaced by your own plugin) that can display media control components, eg.: play/pause button, seekbar, video information such as title and/or description, etc.

Under the hood is a set of stack views divided into panels and position, that can be used to organize the components on the screen.

  • Panels: defines in which part of the screen the plugin will be rendered. The options are

    top
    ,
    center
    ,
    bottom
    and
    modal
    .
  • Position: defines in which part of the panel the plugin will be rendered. The options are

    left
    ,
    center
    ,
    right
    and
    none
    .

Clappr comes with four default components: play/pause button, seekbar, fullscreen button, and time indicator. With them, the user can fully interact with the playback. You can customize it with your own elements, see below:

Media Control Elements

You can add your own components into the

MediaControl
by creating your own Media Control Element.

To do so, you must:

  • Inherit from
    MediaControl.Element
    ;
    • Define in which
      panel
      and
      position
      the element will be rendered;
  • Have a unique name;

If you provide the same name that an existing plugin (built-in), the plugin will override the existent plugin.

You can see some examples:

tvOS

Create

let options = [kSourceUrl : "https://devstreaming-cdn.apple.com/videos/streaming/examples/img_bipbop_adv_example_ts/master.m3u8"]
let player = Player(options: options)

Register Custom Plugins

In order to register a custom plugin is necessary to pass the plugin type to Player before initialize it, using the static method

register
as the example below:
let plugins = [PluginExemplo.self]
WMPlayer.register(plugins: plugins)

var player = WMPlayer(options: options)

player.attachTo(playerContainer, controller: self)

The Player does not support adding or removing plugins at runtime so it is necessary register the plugins before its initialization. In case player be destroyed and recreated, all plugins registered will be reused, like the example below:

let firstTimePlugins = [PluginExemploA.self]
WMPlayer.register(plugins: firstTimePlugins)

var player = WMPlayer(options: options)

let secondTimePlugins = [PluginExemploB.self] WMPlayer.register(plugins: secondTimePlugins)

// PluginExemploB will not be used in this instance of Player player.attachTo(playerContainer, controller: self)

player.destroy()

// PluginExemploA and PluginExemploB will be used in this instance of Player player = WMPlayer(options: options)

Add to your controller

addChildViewController(player)
player.view.frame = view.bounds
view.addSubview(player.view)
player.didMove(toParentViewController: self)

The default configuration assumes fullscreen in tvOS, ensure that the corresponding attached view fills all the window area.

Player also supports embedded mode. For this you'll have to disable MediaControl through options:

kMediaControl: false

You can read more about options here.

Playback State

You can check the playback state by using the state property of

Player
and
Playback
. The states are:
@objc public enum PlaybackState: Int {
    case none = 0
    case idle = 1
    case playing = 2
    case paused = 3
    case stalling = 4
    case error = 5
}

Events

The player throw's a list of events that can be useful to your application.

Options

You can add options to the player. Here you can see the list of available options and how to use it.

External Playback in Background

To enable external playback while your app is in background, you should include the

audio
value to your app's Background Modes capabilities.

Manually editing Info.plist

Add the key

UIBackgroundModes
. Just after adding it to your Info.plist file, Xcode will translate to a more readable value
Required background modes
, which represents an array of values. Then, add a new item with value
audio
, which will be translated to
App plays audio or streams audio/video using Airplay
.

Capabilities Tab

Click on the target that represents your app. Open the Capabilities tab, and there, you'll see the list of available capabilities. One of them is the

Background Modes
. Change its toggle to
on
and mark the
Audio, Airplay, and Picture in Picture
checkbox.

License

You can find it here.

Sponsor

image

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.