Installation Information

• iOS SDK 8.01 or later
• Xcode 7 or later

The SDK is distributed as a zip file with the following contents:

Option 1: Adding WowzaGoCoderSDK.framework to your project (recommended approach)

1. Copy WowzaGoCoderSDK.framework from the SDK distribution folder to somewhere in your project folder.

2. Drag WowzaGoCoderSDK.framework that you just copied into your Xcode project's Project Navigator.

3. In the dialog that will appear, be sure to select Copy items if needed.

4. Select your project in the Project Navigator, and select General in the Project Editor

5. In the Embedded Binaries section, click the + button and in the dialog that appears, select WowzaGoCoderSDK.framework and click the Add button

6. Select your target in the Project Navigator, and select Build Phases in the Project Editor.

7. From the Editor menu, select Add Build Phase > Add Run Script Build Phase (or click the + button in the upper left corner of the Build Phases editor window)

8. The WowzaGoCoderSDK.framework contains both ARM and x86 code; this allows you to use it on a device or in the simulator. The script referenced below will strip the inactive code from the binary, which is a necessary step if you intend to submit your app to the App Store.

9. Expand the disclosure triangle next to the new Run Script phase that was just added. In the script editor box, paste in the following:

    "${BUILT_PRODUCTS_DIR}/${FRAMEWORKS_FOLDER_PATH}/WowzaGoCoderSDK.framework/strip-frameworks.sh"

10. Add the SDK umbrella header to whichever source files you will be referencing the various SDK classes in:

    Objective-C:

     #import <WowzaGoCoderSDK/WowzaGoCoderSDK.h>

    Swift:

     import WowzaGoCoderSDK

Option 2: Adding libWowzaGoCoder.a to your project

1. Copy the wowzagocoder_static_lib folder from the SDK distribution folder to somewhere in your project folder

2. Drag the file libWowzaGoCoder.a (from the wowzagocoder\_static\_lib folder that you just copied) into your Xcode project's Project Navigator

3. In the dialog that will appear, be sure to select Copy items if needed

4. You will probably need to add the static library header file path to your project settings; to do this:

   • Select your project in the Project Navigator, and select Build Settings in the Project Editor

   • Find the Header Search Paths setting, and add the path to wowzagocoder_static_lib/headers. For example, if you added the wowzagocoder_static_lib/headers folder at the same level as your project file, you would enter ./wowzagocoder_static_lib/headers to your header search paths

5. Add the SDK umbrella header to whichever source files you will be referencing the various SDK classes in:

   Objective-C:

    #import "WowzaGoCoder.h"

Define application permissions (iOS 10 and above)

For iOS 10 and above you must define your application permissions using the steps below.

1. Select your build target in the project inspector, and select the Info tab.

2. Add a string-valued key with the name "Privacy - Camera Usage Description" to Custom iOS Target Properties and set it's value to a description of the reason your app needs to use the camera (e.g. "The camera will be used to capture live video for streaming").

3. Add a string-valued key with the name "Privacy - Microphone Usage Description" to Custom iOS Target Properties and set it's value to a description of the reason your app needs to use the microphone (e.g. "The microphone will be used to capture live audio for streaming").

To build and run the sample applications included with the SDK, select any of the Xcode project files included in the SDK sample-apps folder.

In all sample apps, the relevant GoCoder-related sources are the first files (.h and .m) or file (.swift) listed in the Project Navigator.

To facilitate working with the various sample apps, an Xcode workspace named AllSampleApps.xcworkspace is included. This workspace includes the projects listed above.