This framework created to help you include Kinescope player into your mobile iOS application.

This framework can help you include customizable video player into your mobile application, organize offline playing of your videos.

• online and offline playing
• fullscreen, minimal or picture in picture
• customizable UI of player

First of all, init SDK with apiKey somewhere at startup of your app

Kinescope.shared.setConfig(.init(apiKey: "your api key"))

From now you can use most of API through SDK

For example, to get list of videos just call

Kinescope.shared.inspector.list(request: .init(page: 1),
                                onSuccess: { result in

                                  let videos = result.0
                                  // save video models somewhere

                                  let metaData = result.1
                                  // check metadata
                                })

Than init player instance

let player = KinescopePlayer(videoId: "some video id")

Add player view somewhere in your layout

let playerView = KinescopePlayerView()
view.addSubview(playerView)

Connect player and playerView together

player.attach(view: playerView)

Enjoy.

All controls already included into KinescopePlayerView and can be hidden optionally. You can read full documentation or find more examples in our Example-project.

For logging network request, player events or something else use KinescopeDefaultLogger.

First step is set KinescopeLoggerLevel into configuration at application startup:

Kinescope.shared.set(logger: KinescopeDefaultLogger(), levels: [KinescopeLoggerLevel.network, KinescopeLoggerLevel.player])

Use logger like this:

Kinescope.shared.logger.log(message: "Bad Request", level: KinescopeLoggerLevel.network)

or

Kinescope.shared.logger.log(error: NSError(), level: KinescopeLoggerLevel.network)

Also SDK has opportunity to use custom logger. Just use protocols KinescopeLoggingLevel, KinescopeLogging.

Just add KinescopeSDK to your Podfile like this

pod 'KinescopeSDK' ~> 0.1

If you have any issues with method above, than you can specify git repo like this

 pod 'KinescopeSDK', :git => 'https://github.com/kinescope/ios-kinescope-player.git'

Also you can specify concrete branch or tag if you want

 pod 'KinescopeSDK', :git => 'https://github.com/kinescope/ios-kinescope-player.git', :branch => 'master'

All notable changes to this project will be documented in this file.

For issues, file directly in the main repo.

If you would like to contribute to the package (e.g. by improving the documentation, solving a bug or adding a cool new feature), please review our contribution guide first and send us your pull request.

You PRs are always welcome.

MIT License