This repository contains wrappers and a demo project.
Copy LiveComSDK.tsx
file to your project.
Add the following line to your Podfile
pod 'LiveComSDK', :podspec => 'https://customers.s3.sbg.io.cloud.ovh.net/ios/latest.podspec'
Copy LiveComSDK.h
and LiveComSDK.m
files from Wrappers/iOS
folder to {your_project}/ios/LiveComSDK
To initialize LiveCom SDK, you need pass SDK Key, Appearence and ShareSettings objects.
SDK Key is a unique identifier of your application that connects to LiveCom service. You can take SDK Key from your account.
With Appearance you can specify your brand's colors.
ShareSettings allow you to set links for sharing videos and products.
Call this method as soon as possible. Because it needs time to load some data.
import LiveComSDK from './native_modules/LiveComSDK'
...
LiveComSDK.configureWithSDKKey(
sdkKey,
processColor('yellow'),
processColor('red'),
processColor('yellow'),
processColor('red'),
'https://website.com/{video_id}',
'https://website.com/{video_id}?p={product_id}'
)
Add the following code to AppDelegate:
- (BOOL)application:(UIApplication *)application
continueUserActivity:(NSUserActivity *)userActivity
restorationHandler:(void (^)(NSArray<id<UIUserActivityRestoring>> * _Nullable))restorationHandler
{
BOOL linkHandled = [[LiveCom shared] continueWithUserActivity:userActivity];
return linkHandled;
}
To present screen with list of streams above current top view controller just call:
LiveComSDK.presentStreams()
To present stream screen with specific id call:
LiveComSDK.presentStreamWithId(streamId, undefined)
It is possible to display your own screens for product and checkout.
- Set true in these methods:
LiveComSDK.setUseCustomProductScreen(true)
LiveComSDK.setUseCustomCheckoutScreen(true)
- Subscribe to events and open your own screens there:
const liveComEvt = new NativeEventEmitter(LiveComSDK)
...
liveComEvt.addListener('onRequestOpenProductScreen', (product_SKU) => console.log('onRequestOpenProductScreen - ' + product_SKU))
liveComEvt.addListener('onRequestOpenCheckoutScreen', (product_SKUs) => console.log('onRequestOpenCheckoutScreen - ' + product_SKUs))
- Don't forget to call
trackConversion
when user made order with your custom checkout screen:
trackConversionWithOrderId(
orderId: String,
orderAmountInCents: Number,
currency: String,
products: Array<LiveComConversionProduct>
): void;
Example:
LiveComSDK.trackConversionWithOrderId(
"test_react_order_id",
123,
"USD",
[new LiveComConversionProduct("test_sku", "Test product", "test_stream_id", 1)]
)