BiddingStack Video Player for iOS

BiddingStack Video Player iOS Integration Guide

Play BiddingStack video, either single videos or playlists, in your iOS app with the native VideoPlayerView, including ads and fullscreen out of the box.

Requirements

ComponentMinimum Version
iOS Deployment Target14.0+
Swift5.7+

Note: The video player requires an internet connection.

Installation

The SDK is distributed privately while in early access. Contact the BiddingStack team to get the BSVideoPlayer package (Swift Package, CocoaPods, or XCFramework).

Usage

Create the view in code (Interface Builder / storyboards are not supported) and give it an explicit size (e.g. 16:9):

import BSVideoPlayer

let videoPlayer = VideoPlayerView(
  pubId: "YOUR_PUBLISHER_ID",
  videoId: "YOUR_VIDEO_ID"
)
view.addSubview(videoPlayer)

videoPlayer.translatesAutoresizingMaskIntoConstraints = false
NSLayoutConstraint.activate([
  videoPlayer.leadingAnchor.constraint(equalTo: view.leadingAnchor),
  videoPlayer.trailingAnchor.constraint(equalTo: view.trailingAnchor),
  videoPlayer.topAnchor.constraint(equalTo: view.safeAreaLayoutGuide.topAnchor),
  videoPlayer.heightAnchor.constraint(equalTo: videoPlayer.widthAnchor, multiplier: 9.0 / 16.0),
])

To play a playlist instead of a single video:

let playlistPlayer = VideoPlayerView(
  pubId: "YOUR_PUBLISHER_ID",
  playlistId: "YOUR_PLAYLIST_ID"
)

Parameters

ParameterTypeDefaultDescription
pubIdStringrequiredYour BiddingStack publisher ID
videoIdString?nilSingle-video mode; ignored when playlistId is set
playlistIdString?nilPlaylist mode; takes precedence over videoId

Video Content

The Video ID and Playlist ID identify content hosted on SyncCMS. A SyncCMS account is required to upload and manage videos and playlists; copy the IDs from the SyncCMS UI.