Android/Apple Application
The source code of your react native Application must include elements from the Insight React Native Plugin as well as the relevant required React/React Native components needed by your App in js/ts files, for example:
import RNInsight from "@nagra/react-native-insight";
import React, { useEffect, useState } from "react";
import { View, Text, StyleSheet } from "react-native";
...
Intialize Insight session
A session is opened providing the JSON Insight configuration and user information to initialize API.
RNInsight.initialize(insightConfig,userInfo)
Content Information
Set the content information of the current playback content using setVodContent if content is VOD or setLiveContent if content is LIVE
RNInsight.setVodContent(vodContent) // if content is VOD
RNInsight.setLiveContent(liveContent)// if content is LIVE
User Information
Set the user information to be sent to Insight using setUserInfo API. The user information needs to before call play API.
RNInsight.setUserInfo(userInfo)
Start reporting
Start reporting that user started playback of content using play API.The content information needs to be set using RNInsight.setVodContent or RNInsight.setLiveContent APIs before call play API.
RNInsight.play()
Playback events and Content information reporting APIs
Report playback playing event with playing API
RNInsight.playing()
Report the playback pause event with pause API
RNInsight.pause()
Report playback buffering event using buffering API
RNInsight.buffering()
Report that the user started seeking using seeking API
RNInsight.seeking()
Report the position of the seek using seekTo API
RNInsight.seekTo(position)
Report the current position of the playback using setPosition API
RNInsight.setPosition(position)
Report language of the currently selected Audio track using setAudioLanguage API
RNInsight.setAudioLanguage(language)
Report language of the current selected Subtitle track using setSubtitleLanguage API
RNInsight.setSubtitleLanguage(language)
Report the available bitrates for the current playback content using setAvailableBitrates API
RNInsight.setAvailableBitrates(availableBitrates)
Report the playback content current selected bitrate using setBitrate API
RNInsight.setBitrate(bitrate)
Report the playback content quality using setContentQuality
RNInsight.setContentQuality(contentQuality)
Report the number of frame drops to insight using setFrameDrops API
RNInsight.setFrameDrops(frameDrops)
Report offset from live for live content using setOffsetFromLive API
RNInsight.setOffsetFromLive(offset)
Report playback error event using addErrorEvent API
RNInsight.addErrorEvent(code, message)
Report any custom event using addNameEvent API
RNInsight.addNamedEvent(name, description)
Stop reporting
Report the playback stop for content using stop API
RNInsight.stop()
Terminate Insight session
A session is closed by terminate API.
RNInsight.terminate()
Android specific APIs
Report playback error event with type using addErrorEventWithType API
RNInsight.addErrorEventWithType(code, message,type)
Report HTTP request response to Insight using addNetworkEvent API
RNInsight.addNetworkEvent(NetworkEvent)
Get current Insight SDK version using getAgentVersion API
RNInsight.getAgentVersion(callback)
callback=(version)=>{
console.log("Insight version "+version)
}
Get content information reported to Insight using getContent API
RNInsight.getContent(callback)
callback=(content)=>{
console.log("Content information "+content)
}
Report the current playback content bitrate , resolution and codec information using setBitrateResolutionCodec API
RNInsight.setBitrateResolutionCodec(bitrate, resolution,codec)
Report playback content's fps using setFramesPerSecond API
RNInsight.setFramesPerSecond(fps)