Desktop Getting Started

Requirements

  • Latest stable xCode on MacOS
  • Latest stable Microsoft Visual Studio on Windows

Get the client token and configuration file

To start working with the Banuba SDK in your project, you need to have the client token. To receive the client token please fill in our form on banuba.com website, or contact us via info@banuba.com.

Get the Banuba SDK archive

With the client token, you will also receive the Banuba SDK archive for desktop which contains:

  • bnb_sdk folder with dynamic libs and include files,
  • third folder with third-party libraries,
  • resources folder

Build your project with Banuba SDK on Windows

  1. Copy bnb_sdk folder from your SDK archive to your project.

  2. Configure your project to use Banuba SDK:

    1. Open Project Properties -> Linker -> Input and add additional dependencies: bnb_effect_player.lib, bnb_postprocess.lib.

      image

    2. Open Project Properties -> Linker -> General and add additional library directories for each build configuration: bnb_sdk/bin/{platform}/{configuration}. image

    3. Open Project Properties -> VC++ Directories and add include directories: bnb_sdk/include. image

    note

    You need to copy bnb_effect_player.dll and bnb_postprocess.dll to the build directory. You may do this by using a post-build action in your project or just copying manually.

  3. You will also need third-party libraries to run your project with Banuba SDK. You will find them in the third folder in your SDK archive. Copy the third folder to your project.

  4. When you need one of these libraries just configure your project to use this library like at the 2nd point.

    1. For example, you will need to use the glad library. Add glad include directories to your project.

      image

    2. You also need to copy third/openal and third/ffmpeg dlls to the build directory.

  5. Now you can run your project with Banuba SDK.

Build your project with Banuba SDK on MacOS

  1. Copy the bnb_sdk folder from your SDK archive to your project.

  2. Configure your project to use Banuba SDK:

    1. Open Project Build Settings -> Search Paths -> Header Search Paths and add ${PROJECT_DIR}/bnb_sdk/include and choose option recursive.

      image

    2. Open Project Build Settings -> Search Paths -> Header Search Paths and add ${PROJECT_DIR}/bnb_sdk/mac/debug for debug configuration and ${PROJECT_DIR}/bnb_sdk/mac/release for release configuration. image

    3. Open Target Build Settings -> Linking -> Other Linker Flags and add -lbnb_effect_player and -lbnb_post_process flags. image

    note

    You need to copy bnb_effect_player.dylib and bnb_postprocess.dylib to the build directory. You may do this by using a copy files build phase in your project: image image

  3. You will also need third-party libraries to run your project with Banuba SDK. You will find them in the third folder in your SDK archive. Copy the third folder to your project.

  4. When you need one of these libraries just configure your project to use this library like at the 2nd point.

    1. For example, you will need to use the glad library. Add glad include directories to your project.

    image

  5. Now, you can run your project with Banuba SDK.

Last updated on