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";
...
Initialize 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 the content is VOD or setLiveContent if the 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 calling the play API.
RNInsight.setUserInfo(userInfo)
Start reporting
Start reporting that the user started playback of content using the play API. The content information needs to be set using RNInsight.setVodContent or RNInsight.setLiveContent APIs before calling the 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 the language of the currently selected Audio track using setAudioLanguage API.
RNInsight.setAudioLanguage(language)
Report the language of the currently 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 API.
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 fps using setFramesPerSecond API.
RNInsight.setFramesPerSecond(fps)