react-native-rtmp-player-jm

Jimi RTMP Player SDK modules and view for React Native(Android & IOS), support react native 0.57+

Environments 环境要求

1.JS

• node: 8.0+

2.Android

• Android SDK: api 28+
• gradle: 4.5
• Android Studio: 3.1.3+

3.IOS

• XCode: 9.0+

Install 安装

使用 npm 源

npm install react-native-rtmp-player-jm --save

原生模块导入

Android Studio

react-native link react-native-rtmp-player-jm

IOS/Xcode

1、方式一：react-native link react-native-rtmp-player-jm 2、方式二： Podfile 增加

  pod 'React', :path => '../node_modules/react-native', :subspecs => [
    'Core',
    'CxxBridge',
    'DevSupport', 
    'RCTText',
    'RCTNetwork',
    'RCTWebSocket', 
    'RCTAnimation'
  ]
  pod 'yoga', :path => '../node_modules/react-native/ReactCommon/yoga'
  pod 'DoubleConversion', :podspec => '../node_modules/react-native/third-party-podspecs/DoubleConversion.podspec'
  pod 'glog', :podspec => '../node_modules/react-native/third-party-podspecs/glog.podspec'
  pod 'Folly', :podspec => '../node_modules/react-native/third-party-podspecs/Folly.podspec'

  pod 'react-native-rtmp-player-jm', :podspec => '../node_modules/react-native-rtmp-player-jm/ios/react-native-rtmp-player-jm.podspec'

Usage 使用方法

import { Platform, NativeModules, NativeEventEmitter } from 'react-native';
import { JMRTMPMonitorView} from 'react-native-rtmp-player-jm';
const { JMRTMPPlayerManager } = NativeModules;

JMRTMPMonitorView Props 属性

| Prop | Type | Default | Description | ----------------------- |:-----:| :-------:| ------- | image | require | null | Monitor视图默认展示图

JMRTMPPlayerManager Methods

| Method | Listener | Result | Description | ------------------------- | ------- | ------ | ------- | initialize(String key, String secret, String imei) | null | 初始化成功 | RTMP SDK内部初始化 | deInitialize() | null | null | RTMP SDK 释放(解初始化) | startPlayLive() | kOnStreamPlayerPlayStatus | 见回调说明 | 开始播放 | startPlay(String url) | kOnStreamPlayerPlayStatus | 见回调说明 | 使用RTMP URL进行播放 | startPlayback(Array fileNameArray) | kOnStreamPlayerReceiveDeviceData | 见回调说明 | 回放文件，参数为文件名称字符串列表 | stopPlay() | null | null | 停止播放 | startTalk() | kOnStreamPlayerTalkStatus | 见回调说明 | 开始对讲，iOS会自动申请对讲权限，Android需要自己先申请权限 | stopTalk() | kOnStreamPlayerTalkStatus | 见回调说明 | 停止对讲 | stop() | null | null | 停止内部所有功能（播放、对讲，网络请求） | reStart() | null | null | 重启网关、Web服务 | Promise switchCamera(bool isFront, bool bAuto, resolver, rejecter) | Promise | bAuto，默认请填true，成功返回url，否则错误码及错误信息，比如：{ [Error: 设备不在线] code: '228'} | 切换摄像头 | Promise snapshot(String filePath) | Promise | 成功返回保存后的图片路径，否则错误码及错误信息，比如：{ [Error: Failed to do snapshot] code: '-1'} | 视频截图，filePath：需要保存图片的绝对路径，必须以".png"结尾，code:-1，截图失败，-2:保存图片失败，-3:格式无效 | startRecording(String filePath) | kOnStreamPlayerRecordStatus | 见回调说明 | mp4视频录制，filePath：需要保存视频的绝对路径(iOS默认只录制在沙盒，必须以".mp4"结尾) | stopRecording() | kOnStreamPlayerRecordStatus | 见回调说明 | 停止视频录制 | Promise isRecording(resolve, rejecter) | Promise | true：正在录制；false：未录制 | 视频是否在录制 | Promise getRecordingDuration(resolve, rejecter) | Promise | 0 | 视频录制的时长(毫秒) | Promise sendCustomRequest(Map paraDic, resolve, rejecter) | Promise | 0 | 发送自定义指令(请求) | setMute(bool mute) | null | null | 设置静音 | Promise getMute() | Promise | true：静音；false：未静音 | 获取静音状态 | Promise videoSize() | Promise | {"width": 0, "hieght": 0} | 获取视频宽高，只有视频开始且显示画面之后才有效

JMRTMPPlayerManager Listener:- kOnStreamPlayerPlayStatus

| Field | Must Exist | Type | Value | Description | ----------------------- | ------- | ------- | ------ | ------- | status | YES | int | 1~14, "videoStatusPrepare": 正在准备播放; "videoStatusStart": 正在播放; "videoStatusStop": 停止播放；"videoStatusErrURLGet": 获取URL失败；"videoStatusErrURLInvalid": URL无效；"videoStatusErrOpenFail": 打开URL失败；"videoStatusErrOpenTimeout": 打开URL超时；"videoStatusErrPlayAbnormal": 播放异常或设备停止推流(会自动停止播放器)；"videoStatusErrHttpTimeout": http请求超时；"videoStatusErrHttpHost": 域名或IP错误；"videoStatusErrHttpParameter": http参数错误；"videoStatusErrServerData": 服务器数据解析异常；"videoStatusErrDeviceReplayFail": 设备回复“失败”；"videoStatusErrNetworkAnomaly": 网络异常；| 播放状态 | errCode | NO | int | > videoStatusStop，或其他服务器返回错误码| 播放错误码 | errMsg | NO | int | 错误提示语 | 错误提示语，仅当 status===videoStatusErrURLGet 时才有

Code:- PlayStatus

| Code | Description | ----------------------- | ------- | 0 | 未启动或未识别的状态 | 1 | 正在准备播放 | 2 | 开始或正在播放 | 3 | 播放结束 | 4 | 获取URL失败 | 5 | URL无效 | 6 | 打开URL失败 | 7 | 打开URL超时 | 8 | 播放异常或设备停止推流(会自动停止播放器) | 9 | http请求超时 | 10 | 域名或IP错误 | 11 | http参数错误 | 12 | 服务器数据解析异常 | 13 | 设备回复“失败”及拒绝响应 | 14 | 网络异常

JMRTMPPlayerManager Listener:- kOnStreamPlayerTalkStatus

| Field | Must Exist | Type | Value | Description | ----------------------- | ------- | ------- | ------ | ------- | status | YES | int | 1~14, "talkStatusPrepare": 进行对讲准备工作; "talkStatusStart": 对讲已开始; "talkStatusStop": 对讲已停止；"talkStatusErrURLGet": 获取URL失败；"talkStatusErrInit": 初始化对讲URL失败；"talkStatusErrTalking": 正在对讲不能再次开始；"talkStatusErrSend": 发送音频数据失败；"talkStatusErrHttpTimeout": http请求超时；"talkStatusErrHttpHost": 域名或IP错误；"talkStatusErrHttpParameter": http参数错误；"talkStatusErrServerData": 服务器数据解析异常；"talkStatusErrDeviceReplayFail": 设备回复“失败”；"talkStatusErrNetworkAnomaly": 网络异常；"talkStatusErrAuthority": 无麦克风权限 | 播放状态 | errCode | NO | int | > talkStatusStop，或其他服务器返回错误码| 播放错误码 | errMsg | NO | int | 错误提示语 | 错误提示语，仅当 status===talkStatusErrURLGet 时才有

Code:- TalkStatus

| Code | Description | ----------------------- | ------- | 0 | 未启动或未识别的状态 | 1 | 进行对讲准备工作 | 2 | 对讲已开始 | 3 | 对讲已停止 | 4 | 获取URL失败 | 5 | 初始化对讲URL失败 | 6 | 正在对讲不能再次开始 | 7 | 发送音频数据失败 | 8 | http请求超时 | 9 | 域名或IP错误 | 10 | http参数错误 | 11 | 服务器数据解析异常 | 12 | 设备回复“失败”，即表示设备端拒绝对讲或对讲初始化异常 | 13 | 网络异常 | 14 | 无麦克风权限

JMRTMPPlayerManager Listener:- kOnStreamPlayerRecordStatus

| Field | Must Exist | Type | Value | Description | ----------------------- | ------- | ------- | ------ | ------- | status | YES | int | 1~7, "recordStatusStart": 开始录制; "recordStatusComplete": 录制完成; "recordStatusErrRecording": 正在录制；"recordStatusErrFail": 录制失败；"recordStatusErrSave": 保存失败；"recordStatusErrPath": 无效路径；"recordStatusErrAuthority": 无权限； | 录制状态 | filePath | YES | string | 录制视频的保存路径

Code:- RecordStatus

| Code | Description | ----------------------- | ------- | 0 | 未启动或未识别的状态 | 1 | 开始录制 | 2 | 录制完成 | 3 | 正在录制 | 4 | 录制失败 | 5 | 保存失败 | 6 | 无效路径 | 7 | 无权限

JMRTMPPlayerManager Listener:- kOnStreamPlayerReceiveFrameInfo

| Field | Must Exist | Type | Value | Description | ----------------------- | ------- | ------- | ------ | ------- | width | YES | int | 0 | 视频宽度 | height | YES | int | 0 | 视频高度 | videoBps | YES | int | 0 | 视频每秒码率 | audioBPS | YES | int | 0 | 音频每秒高度 | timestamp | YES | int | 0 | 视频时间戳 | totalFrameCount | YES | int | 0 | 视频每秒帧总数 | onlineCount | YES | int | 0 | 设备端在线的人数

JMRTMPPlayerManager Listener:- kOnStreamPlayerReceiveDeviceData

| Field | Must Exist | Type | Value | Description | ----------------------- | ------- | ------- | ------ | ------- | undefine | YES | undefine | null | 回复内容由设备端决定，一般是json字符串或字符串

Code:- DeviceData

| Code | Description | ----------------------- | ------- | 0x3 | 设备端SDK信息 | 0x5 | 响应客户端SDK释放请求 | 0x10 | 在线人数信息 | 0x108 | 单个回放文件结尾 | 0x109 | 所有回放文件结束

Demo示例

https://github.com//Eafy/react-native-rtmp-player-jm/tree/master/example/App.js