Start building apps with the Wowza GoCoder™ SDK for iOS in an Xcode development environment.
Note: Developing apps with the Wowza GoCoder SDK for iOS requires iOS SDK 8.01 or later and Xcode 7 or later. Video playback in GoCoder SDK apps requires iOS 10 or later.
Download and install the tools
Configure an Xcode project to use the Wowza GoCoder SDK
Remove inactive code from the project
Practice with the SDK sample apps
- Download and install the current version of Xcode.
Note: Running and debugging apps that use the GoCoder SDK using a device emulator isn't recommended due to the wide variance in functionality between the software-based audio and video codecs used by the emulator and the hardware-based codecs installed on most devices.
- If you don't have a GoCoder SDK for iOS license, get a free license. If you already have a license for Android, you need to complete the form a second time using an iOS Bundle Identifier to get a license for the GoCoder SDK for iOS.
- Download the current release of Wowza GoCoder SDK for iOS.
- Expand the downloaded .zip file, which contains the following files and folders:
The SDK API reference documentation in HTML format. Open index.html in this folder to view the documentation locally.
Sample code that demonstrates integration between Wowza Streaming Engine™ media server software and the SDK.
A markdown file that contains these release notes.
A set of Xcode projects that demonstrate many of the SDK's capabilities.
A static library version of the GoCoder SDK library for Objective-C applications.
A dynamic framework version of the GoCoder SDK library that supports both Objective-C and Swift-based application development.
Note: Using WowzaGoCoderSDK.framework is recommended over wowzagocoder_static_lib.
To develop iOS apps with the GoCoder SDK, you must configure an Xcode project to recognize the GoCoder SDK framework and add the SDK umbrella header to the project's source files.
- In Xcode, create a project. See Create an app project.
- With the project selected in the navigator area of the Xcode main window, click the File menu and choose Add Files to [project name].
- Navigate to and select WowzaGoCoderSDK.framework in the expanded .zip that you downloaded.
- Under Destination, select Copy items if needed.
- Under Add to targets, select your project.
- Click Add.
- In the editor area of the main window, under the General tab, scroll down to Embedded Binaries and click the + (add) button.
- Select WowzaGoCoderSDK.framework, and then click Add.
Finally, add an umbrella statement to your project's .h or .swift source files so they can reference GoCoder SDK classes.
- In the navigator area, locate your project's AppDelegate and ViewController .h or .swift files.
- Copy one of the following statements into the top of the files, below the commented-out copyright information:
The Wowza GoCoder SDK framework contains both ARM and x86 code, which allows you to use it on a device or in the simulator. If you intend to submit your app to the Apple App Store, run the following script to strip the inactive code from the binary.
- In the editor area of the project's main window, click Build Phases.
- Click the + (add) button in the upper-left corner of the Build Phases editor.
Xcode adds a Run Script build phase to the list.
- Expand the Run Script build phase and paste the following into the script editor field:
To learn more about what you can do with the GoCoder SDK, build and run any of the Xcode projects listed below. These projects are included in the SDK sample-apps folder. You'll first need to get a free license for GoCoder SDK for iOS. If you already have a license for Android, complete the license form a second time using an iOS Bundle Identifier to get a license for the GoCoder SDK for iOS.
To use the sample app projects:
- Update the Bundle Identifier in the Xcode project to the one you entered to get your GoCoder SDK license. This ID is also provided in the license welcome email.
- Replace the SDKSampleAppLicenseKey value (for example: GOSK-8145-010C-2722-98D0-227C) with your license key as needed in the project files. The license key can appear in more than one file in a project. All instances of the license key need to be replaced with your license key.
- An Xcode workspace called AllSampleApps.xcworkspace includes the sample projects.
- The relevant GoCoder-related sources (.h and .m or .swift files) are listed first in the Project navigator.
|All-in-OneSampleApp.objc.xcodeproj||An Objective-C application that demonstrates all of the individual Objective-C sample applications listed here in one application. This application also includes additional applications not listed here, such as an app that demonstrates how to display a bitmap as an overlay on the camera preview.|
|LiveStreamSampleApp.swift.xcodeproj||A Swift application that demonstrates how to use the SDK to capture and broadcast video using the device's internal cameras. The Settings screen in the app allows you to modify various video, audio, capture, and broadcast settings. This app also includes a bitmap overlay feature.|
|MetaDataSampleApp.xcodeproj||An Objective-C application that demonstrates how to use the GoCoder SDK to send a data event (onGetPingTime) to a Wowza Streaming Engine server module that is created and configured to receive the event.|
|PlayerSampleApp.objc.xcodeproj||An Objective-C application that demonstrates how to use the SDK to play a live stream, including an ultra low latency stream from the Wowza Streaming Cloud™ service. This application uses WOWZBroadcast and WOWZPlayer, which decompresses audio and video, and supports HLS fallback when the primary connection fails.|
|PlayerSampleApp.swift.xcodeproj||A Swift application that demonstrates how to use the SDK to play a live stream, including an ultra low latency stream from the Wowza Streaming Cloud™ service. This application uses WOWZBroadcast and WOWZPlayer, which decompresses audio and video, and supports HLS fallback when the primary connection fails.|
|SceneKitReelSampleApp.objc.xcodeproj||An Apple SceneKitReel application modified to support broadcasting the SceneKit app's frame buffer to a Wowza Streaming Engine server. Most of the code is written by Apple; search for
|StreamMP4SampleApp.swift.xcodeproj||A Swift application that demonstrates how to broadcast the frames from a local MP4 file using WOWZBroadcast, WOWZBroadcastComponent, WOWZPlayer, and related classes and protocols.|