Utility Library

Turnkey

Embed-SDK React

Embed-SDK Web

Provides utility hooks and functions to perform app builder specific tasks easily.

turnkey

You can access them under the customization-api module as a named export.

react-sdk

You can access them under the @appbuilder/react module as a named export.

web-sdk

You can access them under the @appbuilder/web module as a named export.

---

useIsVideoEnabled(): isVideoEnabled

Returns a function that checks the video state for a given uid and returns true/false

turnkey

import { useIsVideoEnabled } from "customization-api";

...

const isVideoEnabled = useIsVideoEnabled();

...

if (isVideoEnabled( 123457 )) {
  // if user video enabled
} else {
  // if user video disabled
}

react-sdk

import { useIsVideoEnabled } from "@appbuilder/react";

...

const isVideoEnabled = useIsVideoEnabled();

...

if (isVideoEnabled( 123457 )) {
  // if user video enabled
} else {
  // if user video disabled
}

web-sdk

import { useIsVideoEnabled } from "@appbuilder/web";

...

const isVideoEnabled = useIsVideoEnabled();

...

if (isVideoEnabled( 123457 )) {
  // if user video enabled
} else {
  // if user video disabled
}

Returns:

isVideoEnabled(uid: UidType): boolean

---

useIsAudioEnabled(): isAudioEnabled

Returns a function that checks the audio state for a given uid and returns true/false

turnkey

import { useIsAudioEnabled } from "customization-api";

...

const isAudioEnabled = useIsAudioEnabled();

...

if (isAudioEnabled( 123457 )) {
  // if user audio enabled
} else {
  // if user audio disabled
}

react-sdk

import { useIsAudioEnabled } from "@appbuilder/react";

...

const isAudioEnabled = useIsAudioEnabled();

...

if (isAudioEnabled( 123457 )) {
  // if user audio enabled
} else {
  // if user audio disabled
}

web-sdk

import { useIsAudioEnabled } from "@appbuilder/web";

...

const isAudioEnabled = useIsAudioEnabled();

...

if (isAudioEnabled( 123457 )) {
  // if user audio enabled
} else {
  // if user audio disabled
}

Returns:

isAudioEnabled(uid: UidType): boolean

---

useLocalUid(): UidType

Returns the local user's uid.

turnkey

import { useLocalUid } from "customization-api";

...

const localUid = useLocalUid();

react-sdk

import { useLocalUid } from "@appbuilder/react";

...

const localUid = useLocalUid();

web-sdk

import { useLocalUid } from "@appbuilder/web";

...

const localUid = useLocalUid();

---

getCustomRoute(routeName:string): getCustomRoute

Returns the custom route path

turnkey

import { getCustomRoute } from "customization-api";

...

const customRouteToRedirect = getCustomRoute('custom-page');

react-sdk

import { getCustomRoute } from "@appbuilder/react";

...

const customRouteToRedirect = getCustomRoute('custom-page');

web-sdk

import { getCustomRoute } from "@appbuilder/web";

...

const customRouteToRedirect = getCustomRoute('custom-page');

---

useIsHost(): isHost

Returns a function that checks whether the given uid is a host and returns true/false

turnkey

import { useIsHost } from "customization-api";

...

const isHost = useIsHost();

...

if (isHost( 123457 )) {
  // if user is host
} else {
  // if user is not host
}

react-sdk

import { useIsHost } from "@appbuilder/react";

...

const isHost = useIsHost();

...

if (isHost( 123457 )) {
  // if user is host
} else {
  // if user is not host
}

web-sdk

import { useIsHost } from "@appbuilder/web";

...

const isHost = useIsHost();

...

if (isHost( 123457 )) {
  // if user is host
} else {
  // if user is not host
}

Returns:

isHost(uid: UidType ): boolean

---

---

useFullScreen()

Returns a object that contains requestFullScreen and exitFullScreen function

Note: Its only supported on web platform. click here for more details

turnkey

import { useFullScreen } from "customization-api";

...

const {requestFullScreen,exitFullScreen} = useFullScreen();

//to request full screen
requestFullScreen(123456)
...
//to exit full screen
exitFullScreen()

react-sdk

import { useFullScreen } from "@appbuilder/react";

...

const {requestFullScreen,exitFullScreen}  = useFullScreen();

//to request full screen
requestFullScreen(123456)
...
//to exit full screen
exitFullScreen()

web-sdk

import { useFullScreen } from "@appbuilder/web";

...

const {requestFullScreen,exitFullScreen}  = useIsHost();

//to request full screen
requestFullScreen(123456)
...
//to exit full screen
exitFullScreen()

Returns:

requestFullScreen: (uid: UidType) => Promise

exitFullScreen: () => void

---

useIsAttendee(): isAttendee

Returns a function that checks whether the given uid is an attendee and returns true/false

turnkey

import { useIsAttendee } from "customization-api";

...

const isAttendee = useIsAttendee();

...

if (isAttendee( 123457 )) {
  // if user is attendee
} else {
  // if user is not attendee
}

react-sdk

import { useIsAttendee } from "@appbuilder/react";

...

const isAttendee = useIsAttendee();

...

if (isAttendee( 123457 )) {
  // if user is attendee
} else {
  // if user is not attendee
}

web-sdk

import { useIsAttendee } from "@appbuilder/web";

...

const isAttendee = useIsAttendee();

...

if (isAttendee( 123457 )) {
  // if user is attendee
} else {
  // if user is not attendee
}

Returns:

isAttendee(uid: UidType): boolean

---

useIsPSTN(): isPSTN

Returns a function that checks whether the given uid is a PSTN user and returns true/false

turnkey

import { useIsPSTN } from "customization-api";

...

const isPSTN = isPSTN();

...

if (isPSTN( 123457 )) {
  // if user joined via pstn
} else {
  // if user did not join via pstn
}

react-sdk

import { useIsPSTN } from "@appbuilder/react";

...

const isPSTN = isPSTN();

...

if (isPSTN( 123457 )) {
  // if user joined via pstn
} else {
  // if user did not join via pstn
}

web-sdk

import { useIsPSTN } from "@appbuilder/web";

...

const isPSTN = isPSTN();

...

if (isPSTN( 123457 )) {
  // if user joined via pstn
} else {
  // if user did not join via pstn
}

Returns:

isPSTN(uid: UidType): boolean

---

useHistory: useHistoryHook

Returns the internal "react-router" instance's history object.

turnkey

import { useHistory } from "customization-api";

react-sdk

import { useHistory } from "@appbuilder/react";

web-sdk

import { useHistory } from "@appbuilder/web";

---

useParams: useParamsHook

Returns the navigation parameters passed via the url/path.

turnkey

import { useParams } from "customization-api";

react-sdk

import { useParams } from "@appbuilder/react";

web-sdk

import { useParams } from "@appbuilder/web";

---

---

useHideShareTitle(): HideShareTitle

Returns a function that takes boolean and hide the share tile Note: share tile will be shown to the user only when one user in the call

turnkey

import { useHideShareTitle } from "customization-api";

...

const hideShareTitle = useHideShareTitle();

...
//hide the share title
hideShareTitle(true)

react-sdk

import { useHideShareTitle } from "@appbuilder/react";

...

const hideShareTitle = useHideShareTitle();

...
//hide the share title
hideShareTitle(true)

web-sdk

import { useHideShareTitle } from "@appbuilder/web";

...

const hideShareTitle = useHideShareTitle();

...
//hide the share title
hideShareTitle(true)

Returns:

HideShareTile(hide: boolean ): void

---

isWeb(): boolean

Checks whether the application is running as a web app and returns true/false.

turnkey

import { isWeb } from "customization-api";

...

if (isWeb()) {
  // if running as a web application
} else {
  // if not running as a web application
}

react-sdk

import { isWeb } from "@appbuilder/react";

...

if (isWeb()) {
  // if running as a web application
} else {
  // if not running as a web application
}

web-sdk

import { isWeb } from "@appbuilder/web";

...

if (isWeb()) {
  // if running as a web application
} else {
  // if not running as a web application
}

---

isIOS(): boolean

Checks whether the application is running as an iOS app and returns true/false.

turnkey

import { isIOS } from "customization-api";

...

if (isIOS()) {
  // if running as an ios application
} else {
  // if not running as an ios application
}

react-sdk

import { isIOS } from "@appbuilder/react";

...

if (isIOS()) {
  // if running as an ios application
} else {
  // if not running as an ios application
}

web-sdk

import { isIOS } from "@appbuilder/web";

...

if (isIOS()) {
  // if running as an ios application
} else {
  // if not running as an ios application
}

---

isAndroid(): boolean

Checks whether the application is running as an android app and returns true/false.

turnkey

import { isAndroid } from "customization-api";

...

if (isAndroid()) {
  // if running as an android application
} else {
  // if not running as an android application
}

react-sdk

import { isAndroid } from "@appbuilder/react";

...

if (isAndroid()) {
  // if running as an android application
} else {
  // if not running as an android application
}

web-sdk

import { isAndroid } from "@appbuilder/web";

...

if (isAndroid()) {
  // if running as an android application
} else {
  // if not running as an android application
}

---

isDesktop(): boolean

Checks whether the application is running as an electron desktop app and returns true/false.

turnkey

import { isDesktop } from "customization-api";

...

if (isDesktop()) {
  // if running as an electron desktop application
} else {
  // if not running as an electron desktop application
}

react-sdk

import { isDesktop } from "@appbuilder/react";

...

if (isDesktop()) {
  // if running as an electron desktop application
} else {
  // if not running as an electron desktop application
}

web-sdk

import { isDesktop } from "@appbuilder/web";

...

if (isDesktop()) {
  // if running as an electron desktop application
} else {
  // if not running as an electron desktop application
}

---

isMobileOrTablet(): boolean

Checks whether the application is running as a web application on a mobile or tablet device and returns true/false.

turnkey

import { isMobileOrTablet } from "customization-api";

...

if (isMobileOrTablet()) {
  // if running as a web application on a mobile or tablet device and returns true/false.
} else {
  // if not running as a web application on a mobile or tablet device and returns true/false.
}

react-sdk

import { isMobileOrTablet } from "@appbuilder/react";

...

if (isMobileOrTablet()) {
  // if running as a web application on a mobile or tablet device and returns true/false.
} else {
  // if not running as a web application on a mobile or tablet device and returns true/false.
}

web-sdk

import { isMobileOrTablet } from "@appbuilder/web";

...

if (isMobileOrTablet()) {
  // if running as a web application on a mobile or tablet device and returns true/false.
} else {
  // if not running as a web application on a mobile or tablet device and returns true/false.
}

---