I develop code in .

Select your preferred language to get started

Getting Started

This introduction will show you how to add video upload functionality to your mobile app using the SYNQ Android SDK.

There are three parts involved when a mobile client is interacting with SYNQ:

  1. The SYNQ mobile SDK, in your app
  2. The SYNQ Video API, on our servers
  3. Your own server making requests to the SYNQ API and passing data to your app

In this guide we will be going through the following steps:

 

Adding the SYNQ Android SDK:

Make sure that your project’s build.gradle file is using the JCenter repository:

SynqAndroid can be integrated into your project by adding the following dependency to your app’s build.gradle:

Add the following imports where you would like to use the uploader:

Create an instance of the uploader:

Configuring Video Objects in the SYNQ API

Before you can upload a video, you must create a video object in the SYNQ API. You should have your own backend doing this. In the following section we will use our example Node server to illustrate how this can be done. To make requests to the example server, we´ll be using a module called synqhttplib (synqhttplib is included in the SynqAndroid repository).

Add synqhttplib by adding this dependency to your app’s build.gradle:

Import the SynqHttpClient class:

Create an instance of the HTTP client:

Please note: the example server expects you to authorize a user before calling any other functions. This is outside the scope of this guide, but you’ll find code examples for authorizing users in the SynqAndroid repository.

Creating a video object via our example server will return upload parameters in the form of a JsonObject. This object should be passed to the upload function afterwards:

Uploading your Video

Initiate the upload by calling the upload function using the upload parameters:

Getting Started

Our API can help you with the uploading and playback of videos. To use our API, you need to have an API key, Get your free API key here.

Install:

Add SynqElixir to your list of dependencies in min.exs:

Or from hex:

Ensure you list synq_elixir in application dependency in your mix.exs file:

Usage:

//Create video object

Getting Started

This introduction will show you how to add video upload functionality to your mobile app using the SYNQ iOS SDK.

There are three parts involved when a mobile client is interacting with SYNQ:

  1. The SYNQ mobile SDK, in your app
  2. The SYNQ Video API, on our servers
  3. Your own server making requests to the SYNQ API and passing data to your app

In this guide we will be going through the following steps:

Adding the SYNQ iOS SDK:

Our SDK for iOS is available in both Swift and Objective-C versions, so you’ll be able to choose which one suits your project best. They are available through CocoaPods. We’ll use the Swift version in this guide, but the Objective-C version is available on GitHub or via CocoaPods.

To install it, simply add the following line to your Podfile:

pod 'SynqSwift'

Then install by running this command in your project directory in Terminal:

pod install

If you get an error saying Unable to find a specification for `SynqSwift`, you might need to update your cocoapods repo. Run the command pod repo update, and then run pod install again.

Add the following imports where you would like to use the SDK:

To be able to handle upload results, add the SQVideoUploadDelegate protocol to your class:

Add the functions declared by the SQVideoUploadDelegate protocol to your class:

These functions can be used to handle video upload outcome.

Initialize an instance of the SynqUploader, and set your class as the delegate:

Create a SQVideoUpload object for each PHAsset to be uploaded:

Configuring Video Objects in the SYNQ API

Before you can upload a video, you must create a video object in the SYNQ API. You should have your own backend doing this. In the following section we will use our example Node server to illustrate how this can be done. To make requests to the example server, we´ll be using another library called SynqHttpLib. This library got added to your project when you added the SynqSwift pod, as it is declared as a dependency for SynqSwift. Start off by importing the SynqHttpLib module:

Then create an instance of the HTTP client:

Please note: the example server expects you to authorize a user before calling any other functions. This is outside the scope of this guide, but you’ll find code examples for authorizing users in the SynqSwift repository.

Creating a video object via our example server will return upload parameters in the form of a Dictionary. These parameters should then be set in our SQVideoUpload object:

Uploading your Video

We are ready to upload our video. The upload function requires an array of video objects, so we simply add our single video to an array:

Finally, call the upload function:

Getting Started

This introduction will show you how easy it is to upload and deliver a video using our Node sdk through a few easy steps.

  1. Creating the video object
  2. Getting an embeddable uploader that your users can drag and drop a video into
  3. Getting an embeddable HTML5 web player that you can display to your user

Please refer to the complete documentation on github for more examples, or take a look at our example Node server for a complete running example using this sdk.

Installation:

npm install --save synq

Usage:

Creating the Video Object:

First you create a video object that we later can upload a video file into:

Getting the Embeddable Uploader:

We then add a call to uploader to get an embeddable uploader that we can show to the end user

Getting the Player:

When you want to display the video you either use the video_id for the specific video object  or you can query the metadata for a subset of your videos. The url for the player is located in the video object and can be embedded in an iframe. If you want to show the video in high quality you should wait for transcoding to finish, you can know what state the video is in by using webhooks.

The following example console.logs the url to the player, the number of views and the thumbnail url for a video with a specific video_id:

Getting Started

This introduction will show you how easy it is to upload and deliver a video using our PHP SDK through a few easy steps. The examples shown here are for PHP7, if you need an SDK for PHP5, click here.

  1. Creating the video object
  2. Getting an embeddable uploader that your users can drag and drop a video into
  3. Getting an embeddable HTML5 web player that you can display to your user

Please refer to the complete documentation on github for more examples.

Installation:

Use composer - https://getcomposer.org

Usage:

Creating the Video Object:

First you create a video object that we later can upload a video file into:

Getting the Embeddable Uploader:

We then add a call to uploader to get an embeddable uploader that we can show to the end user

Getting the Player:

When you want to display the video you either use the video_id for the specific video object  or you can query the metadata for a subset of your videos. The url for the player is located in the video object and can be embedded in an iframe. If you want to show the video in high quality you should wait for transcoding to finish, you can know what state the video is in by using webhooks.

The following example prints the url to the player, the number of views and the thumbnail url for a video with a specific video_id:

Getting Started

This introduction will show you how easy it is to upload and deliver a video using our Python sdk through a few easy steps.

  1. Creating the video object
  2. Getting an embeddable uploader that your users can drag and drop a video into
  3. Getting an embeddable html5 web player that you can display to your user

Please refer to the complete documentation on github for more examples.

Install:

pip install synq

Usage:

Creating the Video Object:

First you create a video object that we later can upload a video file into:

Getting the Embeddable Uploader:

We then add a call to uploader to get an embeddable uploader that we can show to the end user

Getting the Player:

When you want to display the video you either use the video_id for the specific video object  or you can query the metadata for a subset of your videos. The url for the player is located in the video object and can be embedded in an iframe. If you want to show the video in high quality you should wait for transcoding to finish, you can know what state the video is in by using webhooks.

The following example prints the url to the player, the number of views and the thumbnail url for a video with a specific video_id:

open_in_new

API Reference

Get in-depth information about SYNQs API and SDKs. Authentication functions, parameters, response formats, and error codes - find it all here.

open_in_new

SDKs on GitHub

Easily use SYNQs API in the programming language of your choice. Download and install helpers for Objective-C, Java, JavaScript, Python and more.