nkotak1 / oddworks-ios-tvos-sdk

Apple iOS and tvOS SDK for Oddworks

Apple iOS & tvOS SDK for Oddworks

An Oddworks device client SDK for Apple TV, iPhone, and iPad. Check out Odd Networks for more information.

• Create a new streaming app for iPhone and iPad
• Create your own channel on Apple TV
• Augment your existing iOS or tvOS app with video streaming content from Oddworks.
• Take down the establishment.

The iOS/tvOS Frameworks for Odd Networks are written in Swift. Objective-C target applications are fully supported. You may refer to our sample apps for how to work with the SDK in both Swift and Objective-C.

Become your own video distribution channel!

Table of contents

• Resources
• Oddworks Content Server
• Oddworks Sample Apps
• Oddworks Apple Guide
• Technology
• Versioning
• Motivation
• Community
• License

Resources

Oddworks Content Server

The Oddworks iOS/tvOS SDK is designed specifically as a client for the open source Oddworks Content Server. Together the server and client allow you to structure your content and deliver it specifically to your application.

Oddworks Sample Apps

The sample apps are designed as reference apps for creating content rich applications for iOS and Apple TV. These are open source as well, and should provide the quickest way to get started with this SDK for your app.

• Apple iOS & tvOS SDK (you are here) Used for iPhone, iPad, and Apple TV.
• Android SDK Used for mobile, tablet, Android TV, and Fire TV.

Coming soon:

• Roku SDK
• JavaScript SDK for use in Windows Universal and web applications.

Oddworks Apple Guide

The guide contains the full documentation for working with Apple devices in the Oddworks ecosystem.

• Quick Start
• Overview
• Full Walkthrough

Technology

The Oddworks Platform is written for the Node.js runtime, and uses the well known Express.js framework for HTTP communication.

Oddworks is designed to be database agnostic so long as the underlying database can support JSON document storage, including some RDMSs like PostgreSQL. Currently the only supported and tested database is MongoDB.

Although communication between the devices and the REST API is typically done in a synchronous way, the inner guts of the system is designed to communicate via asynchronous message passing. This makes it easier to extend the platform with plugins and other loosely coupled modules without worrying about upstream changes like you would in tightly coupled platforms.

Versioning

For transparency into our release cycle and in striving to maintain backward compatibility, Oddworks is maintained under the Semantic Versioning guidelines.

Motivation

The Oddworks Platform was designed and developed by Odd Networks to lower the barrier for developers and content owners to create your own streaming content network. Based on our experience in video gaming we thought that TV could use a big improvement. We believe in the future of television and, with the Oddworks open source platform, we hope you'll make that future a reality.

We proudly stand behind our open source work and, in addition to maintaining the Oddworks project, Odd Networks also provides hosted services, a Pro Dashboard, a Live Stream Generator, and a Recommendation Service.

Check out www.oddnetworks.com

Community

Get updates on Odd Network's development and chat with the project maintainers and community members.

• Follow @oddnetworks on Twitter.
• Join the official Slack room.
• Submit an issue.
• Check out the API sample responses.
• Read and subscribe to The Official Odd Networks Blog.

License

Apache 2.0 © Odd Networks