Low-Latency Live Streaming
  • iOS : Objective-C
  • Android
  • macOS
  • Windows
  • Web
  • Overview
  • SDK downloads
  • Sample codes
  • Quick starts
  • Common features
  • Advanced streaming
  • Advanced video processing
  • Advanced audio processing
  • Others
  • Best practices
  • Error codes
  • Server APIs
  • API Documents
  • FAQ
Sample Code
Download

Guidelines for Running Sample Codes

ZEGO no longer classifies environments into production environments and testing environments.

If you create your project in ZEGO Admin Console on/before 2021-11-16, refer to the Testing environment deprecation to upgrade the SDK and adjust related codes.

1 Prepare the Environment

Please ensure that the development environment meets the following technical requirements:

  • Xcode 7.0 or above.
  • iOS device or simulator with iOS 9.0 or above and supports audio and video (real device is recommended).
  • The iOS device is connected to the Internet.

2 Prerequisites

Please go to ZEGO Admin Console to register an account and apply for the AppID and AppSign required to initialize the SDK. For the application process, please refer to ZEGO Admin Console User Manual.

3 Run the Sample Codes

  1. Open AppStore, search for "Xcode", download and install it.

  2. Use Xcode to open "ZegoExpressExample.xcodeproj".

    1. Open Xcode and select "File > Open..." in the upper left corner.

    2. Select "ZegoExpressExample.xcodeproj" in the unzipped sample code folder, and click "Open".

  3. Log in to your Apple ID account.

    1. Open Xcode and select "Xcode > Preferences..." in the upper left corner.

      /Pics/iOS/ZegoExpressEngine/Common/xcode_preferences.png

    2. Click the "Account" tab, click the "+" in the lower left corner to sign, select to add an Apple ID, and click "Continue".

    3. Enter Apple ID and Password to log in.

  4. Modify the developer certificate and Bundle Identifier.

    1. Open Xcode and click the "ZegoExpressExample" project on the left.

    2. Open the ARGETS. Developers can click the "General" tab to modify the Bundle Identifier of the project according to their needs; click the "Signing & Capabilities" tab to select their own developer certificate.

      /Pics/iOS/ZegoExpressEngine/Common/bundle_id.png
      /Pics/iOS/ZegoExpressEngine/Common/team_signing_new.png

  1. The downloaded sample code lacks the AppID and AppSign required for SDK initialization. You need to modify the "KeyCenter.m" file in the "ZegoExpressExample" directory. Please use the AppID and AppID obtained in the 2 Prerequisites of this article. Fill in AppSign correctly, otherwise the sample code will not run normally.

    + (unsigned int)appID {
        return 1333333333; // Please enter your AppID
    }
    
    + (NSString *)appSign {
        return @"abcdefghijklmnopqrstuvwzyv123456789abcdefghijklmnopqrstuvwzyz123";  // Please enter your AppSign
    }
  2. Connect the iOS device to the development computer, click "Any iOS Device" in the upper left corner of Xcode to select the iOS device (or simulator).

    /Pics/iOS/ZegoExpressEngine/Common/xcode_select_device_new.png
    /Pics/iOS/ZegoExpressEngine/Common/xcode_select_real_device_new.png

  3. Click the Build button in the upper left corner of Xcode to compile and run the sample code.

    /Pics/iOS/ZegoExpressEngine/Common/build_and_run_new.png

4 Experience Real-time Audio and Video Functions

We recommend you run your project on a real device. If your app runs successfully, you should hear the sound and see the video captured locally from your device.

To test out the real-time audio and video features, visit the ZEGO Express Web Demo, and enter the same AppID, Server and RoomID to join the same room. If it runs successfully, you should be able to view the video from both the local side and the remote side, and hear the sound from both sides as well.

In audio-only scenarios, no video will be captured and displayed.

FAQ

  1. Compile the sample code time report 'The app ID "im.zego.ZegoExpressExample" cannot be registered to your development team. Change your bundle identifier to a unique string to try again.' What should I do?

    Refer to the steps of "Modify Developer Certificate and Bundle Identifier" in the above Guidelines for Running Sample Codes, switch to your own development certificate in "Targets > Signing & Capabilities" and modify "Bundle Identifier" before running.