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.
| Component | Minimum Version |
|---|---|
| iOS Deployment Target | 14.0+ |
| Swift | 5.7+ |
Note: The video player requires an internet connection.
The SDK is distributed privately while in early access. Contact the BiddingStack team to get the BSVideoPlayer package (Swift Package, CocoaPods, or XCFramework).
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"
)
| Parameter | Type | Default | Description |
|---|---|---|---|
pubId | String | required | Your BiddingStack publisher ID |
videoId | String? | nil | Single-video mode; ignored when playlistId is set |
playlistId | String? | nil | Playlist mode; takes precedence over videoId |
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.