Player

Normal

small_api-video-romain-petit.png

thumbnail_api-video-romain-petit.png

api-video-romain-petit.png

Romain Petit

Tutorials

Swift

Have you already developed your own player, but find it challenging to switch to the api.video player?

We have a solution. In this tutorial, we will demonstrate how to play a video from api.video on your player.

## Before starting

Before you start, make sure that you have already uploaded at least one video to api.video. If you haven't done so yet, you can follow this [guide](https://docs.api.video/docs/upload-a-video-regular-upload) for assistance.

## Extensions

In this tutorial, we will discuss extensions. If you are not familiar with extensions, I will explain them briefly, but if you are, feel free to skip ahead.

Extensions enable you to add custom functionality to a code without altering the original implementation.

For example, let's say you have a struct named "Person" with "firstname" and "lastname" as properties. You can create an extension to retrieve their full name.

 ## Adding the api.video Swift player library

In this section, we will cover the two main steps involved in adding the api.video Swift player to your project:

1. Get the latest version by accessing it [here](https://github.com/apivideo/api.video-swift-player/releases).
2. Add the `ApiVideoPlayer` package to your app using one of the following methods:

    a. SPM:
	* In the Project Navigator, select your project.
	* Click on the "Package Dependencies" tab in the Project section.
	* Click the "+" button at the bottom.
	* Paste the URL below into the search bar in the top right.
	* Finally, click the "Add package" button.


  b. Cocoapods:
* Add the following to your Podfile.

## VideoOptions

Every video on api.video is assigned a unique identifier called the `videoId`, which can be found on the Dashboard or in the video list.

As you follow this tutorial, make sure to replace `YOUR_VIDEO_ID` with the actual `videoId` of your video.

If you are using private videos, it will be necessary to provide the private token as well.

A private token is an exclusive token that guarantees access to a specific private video, but it can be used only once.

## AVPlayer Extension

The api.video Swift Player provides an extension for playing new videos with AVPlayer:

If, for any reason, you encounter an error with the HLS stream, you can try again with an MP4 video.

To do this, you need to add an observer to your player and retry when the status fails:

Congrats, you did it; you can now play your video from [api.video](http://api.video) 🥳🥳🥳🥳

(!) To get info on failed mp4, feel free to add an else statement after the if 

## Explore more

With the Swift Player client, you are not limited to just replacing the `currentItem`.

It offers the flexibility to construct a player by using either UIKit or SwiftUI.

To explore this feature further, I suggest checking out this [article](https://api.video/blog/tutorials/how-to-add-an-api-video-swift-player-to-your-ios-application) or the project on [GitHub](https://github.com/apivideo/api.video-swift-player).

large_28mar23-copie.png

medium_28mar23-copie.png

small_28mar23-copie.png

thumbnail_28mar23-copie.png

28mar23-copie.png

Switch to api.video Swift player

swift

We have now released the Swift player! The Swift player helps you to playback your videos easily in your iOS and iPadOS applications.

In this tutorial we will see how to add the Swift player to your code.

The [Swift player package](https://github.com/apivideo/api.video-swift-player) allows you to use UIKit and SwiftUI to handle multi-platform projects.
The Swift player package is available on both Cocoapods and Swift Package Manager (SPM).

Before starting with this tutorial, make sure that you set your minimum target to iOS 13 and above.

To just give you a quick preview, we are going to create a Swift application with an api.video player that looks like this:

small_capture-d-ecran-2023-03-16-a-16-15-48.png

thumbnail_capture-d-ecran-2023-03-16-a-16-15-48.png

capture-d-ecran-2023-03-16-a-16-15-48.png

## Upload video

Before starting to add the api.video Swift player to your application, you need to upload at least one video to your api.video account. If you haven't yet, see [how to upload a video](https://docs.api.video/docs/upload-a-video-regular-upload).

You'll need a video Id to use this component and play a video from api.video. To get yours, follow these steps:

1. [Log into your account](https://dashboard.api.video/login) or create one [here](https://dashboard.api.video/register).
2. Copy your API key (sandbox or production if you are subscribed to one of our [plans](https://api.video/pricing)).
3. Go to the official [api.video documentation](https://docs.api.video/docs).
4. Log into your account in the top right corner. If it's already done, make sure that it's the account you want to use.
5. Go to *API Reference* -> *Videos* -> *[List all videos](https://docs.api.video/reference/list-videos)*
6. On the right, be sure the *Authentication* section contains the API key you want to use.
7. Generate your upload token by clicking the *Try It!* button in the right section
8. Copy the *videoId* value of one of elements of the response in the right section.

Alternatively, you can find your video Id in the video details of your [dashboard](https://dashboard.api.video/).

## Add the api.video Swift player

In this section, we will go through the three main steps of adding the [api.video](http://api.video/) Swift player to your iOS application.

1. Get the latest version
    
    You can find it in the [release page](https://github.com/apivideo/api.video-swift-player/releases)
    
2. Add the `ApiVideoPlayer` package to your app with:
    1. SPM
        
        Add the following to your package.swift

2. Cocoapods
    
    add the following to your Podfile

Replace X.X.X with the latest version.

3. UIKit
    
    a. Import the package

(!) Replace “YOUR_VIDEO_ID” by your own videoId to display video

(!) Replace “YOUR_PRIVATE_TOKEN” by the private token of the video to display it.

c. To get all player events (optional)

d. Implement the player view in your view controller and add constraints.

4. SwiftUI
    
    a. Import the `ApiVideoPlayer` package

b. In your view you have to instantiate the player and the player events in the init method

(!) Replace “YOUR_VIDEO_ID” by your own videoId to display video

If you want to play private videos:

c. In the body you have to add the player with the specification you want

You will be able to use all the methods available externally, by calling player.methodName, for example :

If you're looking for an easy way to integrate video into your application, check out our **[docs](https://docs.api.video/docs)** and **[sign up for a free account](https://dashboard.api.video/register).**

large_api-video-swift-player.png

medium_api-video-swift-player.png

small_api-video-swift-player.png

thumbnail_api-video-swift-player.png

api-video-swift-player.png

How to add an api.video Swift player to your iOS application

API client

thumbnail_thibault_rond.png

thibault_rond.png

Thibault Beyou

Product updates

[api.video](https://api.video) removes the complexity from streaming video. Our simple to use APIs allow you to focus on creating your content -- leave the video streaming details to us.

Few months ago, we announced our [Android API client](https://github.com/apivideo/api.video-android-client), we are now happy to announce the release of our [iOS API client](https://github.com/apivideo/api.video-ios-client). We are replacing the iOS SDK to simplify api.video usages and deployment of the new version. It also provides support for [api.video progressive upload](https://api.video/progressive-upload). We will focus on the progressive upload part in another blog articles.

The [iOS API client](https://github.com/apivideo/api.video-ios-client) comes with:
* [documentation](https://github.com/apivideo/api.video-ios-client#documentation
* [sample code](https://github.com/apivideo/api.video-ios-client/tree/main/Example).

This article is a walkthrough to upload a file with [iOS API client](https://github.com/apivideo/api.video-ios-client).

## Installation
### Cocoapods

1.  Add the following entry to your `Podfile`:

2. Then run `pod install`

3. Import ApiVideoClient in every file you’d like to use [iOS API client](https://github.com/apivideo/api.video-ios-client).

### Carthage

1.  Add the following entry to your `Cartfile`:

2. Then run `carthage update`

3. Import ApiVideoClient in every file you’d like to use [iOS API client](https://github.com/apivideo/api.video-ios-client).

## iOS API configuration

To use the iOS API client, you first have to import the `ApiVideoClient`.

`ApiVideoClient` class provides static fields and methods to configure the iOS API client. You can set your API key, your environment (sandbox or production), chunk size,...

Set your API key with:


If you want to target the sandbox environment:

## Create a video file

If you haven't create a video on api.video, you have to create a video entry on api.video platform with:

Description of the fields of `VideoCreationPayload` is provided [here](https://github.com/apivideo/api.video-ios-client/blob/main/docs/VideoCreationPayload.md).

## Upload a video file

To upload a file, you will have to get the `URL` of your file. You can get it from the image picker component. Have a look at our a [sample code](https://github.com/apivideo/api.video-ios-client/tree/main/Example).


If you want to draw a progress bar that displays the upload progress, there is a `onProgressReady: ((Progress) -> Void)` parameter to the `upload` method.

## iOS API client capabilities

The [iOS API client](https://github.com/apivideo/api.video-ios-client) provides methods to perform every possible actions on the [api.video](https://api.video) API such as list videos (with filters), delete video, add/remove captions,...
If you are not familiar with [api.video](https://api.video) API, you should have a look on [api.video documentation documentation](https://docs.api.video/reference/overview). You will find the same concepts in the [iOS API client documentation](https://github.com/apivideo/api.video-ios-client#documentation). 

## iOS video uploader

If you want to develop an application that only uploads video files. You should have a look at the [iOS video uploader](https://github.com/apivideo/api.video-ios-uploader).

Don't hesitate to share your feedback on [our community](https://community.api.video/). Happy building!

medium_8cd3ef2e-d0ab-4465-86ae-624889fa945d.png

small_8cd3ef2e-d0ab-4465-86ae-624889fa945d.png

thumbnail_8cd3ef2e-d0ab-4465-86ae-624889fa945d.png

8cd3ef2e-d0ab-4465-86ae-624889fa945d.png

New iOS API client

iOS SDK

doug.jpg

twitter-brands.svg

Doug Twitter

Doug Sillars

[api.video](https://api.video) removes the complexity from streaming video. Our simple to use APIs allow you to focus on creating your content, and leaving the video streaming details to us.

Since launching api.video, one of the most common questions we are asked is “do you have mobile SDKs?” Today, we can answer that with a “yes!”

Late last year, we announced our [Android SDK](https://github.com/apivideo/android-sdk), and today we are happy to announce the release of our [iOS SDK](https://github.com/apivideo/ios-sdk). If you have used api.video in the past, you’ll see that all of the features that are available in our APIs are now available as native iOS calls.

If you have never used api.video, imagine a simple API interface to upload, modify, and delete video streams, create custom players, add captions or chapters, and even live stream video — all from the native app. That is the power that api.video (and all of our [SDKs](https://docs.api.video/docs/)) can give you. To get started, read the documentation on [GitHub](https://github.com/apivideo/ios-sdk), and check out the [demo application code](https://github.com/apivideo/ios-demo) (launching this week).

The quick start guide (pulled from GitHub):

## Installation

### Cocoapod

1.  Add the following entry to your Podfile:

2. Then run pod install

3. Don’t forget to import sdkApiVideo in every file you’d like to use api.video sdk

### Quick Start

### 1\. In the AppDelegate.swift instantiate a new Client


### 2\. In the didFinishLaunchingWithOptions func add the following code

*   If you want to use the production environment, use createProduction method
*   If you want to use the sandbox environment , use createSandbox method

### 3\. In your ViewController.swift file import the sdk

And that’s all there is to it!

Now you can use all your favourite api.video calls in your mobile app, simplifying the delivery of your videos with one API to apps, browsers and billions of devices around the world.

If you have questions, file an [issue](https://github.com/apivideo/ios-sdk/issues), or reach out to us on [chat](https://api.video).

medium_1595510872-iossdk-1.jpg

small_1595510872-iossdk-1.jpg

thumbnail_1595510872-iossdk-1.jpg

1595510872-iossdk-1.jpg

api.video launches iOS SDK

Featured article

# api.video blog

Blog

Follow the api.video Blog to explore tutorials, video use cases, and learn about on-demand and live-streaming video updates.