1.1 demo说明

• SmartU3dAndroidPlayer: 大牛直播SDK Unity3D Android RTMP/RTSP直播播放端工程。

1.2 功能说明

标准接口：

• 音频：AAC/G.711/speex；
• 视频：264；
• 播放协议：RTMP/RTSP；
• 支持RTSP TCP/UDP模式切换；
• 支持纯音频、纯视频、音视频播放；
• 支持秒开模式；
• 音视频多种render机制;
• 支持buffer设置；
• 真正靠谱的超低延迟；
• 支持多实例播放；
• 支持播放url快速切换；
• 断网自动重连，支持视频追赶；
• 支持视频video实时旋转。

增值接口：

• 同时支持rtsp、rtmp播放；
• 播放过程中，实时静音、取消静音；
• 播放端回调YUV，供unity3d调用完成绘制；
• 实时快照；
• 实时录像。

1.3集成说明

• Unity3D接口和调用demo，参见：SmartPlayerAndroidMono.cs
• SmartU3dAndroidPlayer\Assets\Plugins\Android\libs下相关库到工程：
• Smartavengine.jar加入到工程；
• smartplayerunity3d.jar加入工程；
• libs\arm64-v8a 和 SmartPlayer\libs\armeabi 下 libSmartPlayer.so。

• 在SmartU3dAndroidPlayer\Assets\Plugins\Android\AndroidManifest.xml配置相关权限：

<uses-permission android:name=”android.permission.WRITE_EXTERNAL_STORAGE” > </uses-permission>

<uses-permission android:name=”android.permission.INTERNET” ></uses-permission>

<uses-permission android:name=”android.permission.MOUNT_UNMOUNT_FILESYSTEMS” />

<uses-permission android:name=”android.permission.MODIFY_AUDIO_SETTINGS” />

• 如需集成到自己系统测试，请用大牛直播SDK的app name(不然集成提示license failed)，正式授权版按照授权app name正常使用即可:
• 如何改app-name：
• Unity3D模式下：File–>Build Settings–>Android–>Player Settings，设置Product Name。

1.4 调用时序(V2)

1. 【最先调用】NT_U3D_Init：player初始化，目前预留；
2. 【获得player句柄】NT_U3D_Open，设置上下文信息，返回player句柄；
3. 【设置GameObject】NT_U3D_Set_Game_Object，注册Game Object，用于消息传递；
4. 【设置硬解码】NT_U3D_SetVideoDecoderMode，设置是否用硬解码播放，如硬解码不支持，自动适配到软解码；
5. 【audio输出类型】NT_U3D_SetAudioOutputType()，如果use_audiotrack设置为0，将会自动选择输出设备，如果设置为1，使用audiotrack模式；
6. 【缓冲设置】NT_U3D_SetBuffer，设置播放端缓存数据buffer，以毫秒(ms)为单位，如超低延迟模式下，不需buffer数据，设置为0；
7. 【RTSP TCP/UDP设置】NT_U3D_SetRTSPTcpMode，设置TCP/UDP播放模式，注意：此接口仅用于RTSP；
8. 【实时静音-可实时调用】NT_U3D_SetMute，设置播放过程中，实时静音/取消静音；
9. 【快速启动】NT_U3D_SetFastStartup，Set fast startup(快速启动)，设置快速启动后，如果CDN缓存GOP，daniulive player可快速出帧；
10. 【低延迟模式】NT_U3D_SetPlayerLowLatencyMode，针对类似于直播娃娃机等期待超低延迟的使用场景，超低延迟播放模式下，延迟甚至可达到200~400ms；
11. 【视频显示角度设置-可实时调用】NT_U3D_SetRotation，针对类似于安防摄像头或其他设备出来的图像倒置现象，支持视频播放view顺时针旋转, 当前支持 0度，90度, 180度, 270度 旋转，注意除了0度之外， 其他角度都会额外消耗性能；
12. 【下载速度回调设置】NT_U3D_SetReportDownloadSpeed，设置下载速度上报, 默认不上报下载速度；
13. 【快照设置】NT_U3D_SetSaveImageFlag()，设置是否需要在播放或录像过程中快照；
14. 【快照-录像或播放后，可随时调用】NT_U3D_SaveCurImage，播放过程中，根据设置路径和文件名，实时快照；
15. 【快速切换url-可实时调用】NT_U3D_SwitchPlaybackUrl，快速切换播放url，快速切换时，只换播放source部分，适用于不同数据流之间，快速切换（如娃娃机双摄像头切换或高低分辨率流切换）；
16. 【录像设置】NT_U3D_CreateFileDirectory，创建文件路径；
17. 【录像设置】NT_U3D_SetRecorderDirectory，设置文件路径；
18. 【录像设置】NT_U3D_SetRecorderFileMaxSize，设置每个录像文件最大size，以兆（M）为单位，范围(5M~500M)；
19. 【设置播放或录像URL】NT_U3D_SetUrl，设置播放/录像url；
20. 【播放】NT_U3D_StartPlay，开始播放；
21. 【播放】NT_U3D_GetVideoFrame，获取底层回调的YUV数据；
22. 【播放】NT_U3D_StopPlay，停止播放；
23. 【录像】NT_U3D_StartRecorder，开始录像；
24. 【录像】NT_U3D_StopRecorder，停止录像；
25. 【关闭】NT_U3D_Close, 关闭播放器实例；
26. 【最后调用】NT_U3D_UnInit，UnInit Player，最后调用。

1.5 Event回调

/// <summary>

/// android 传递过来 code

/// </summary>

/// <param name=”code”></param>

public void onNTSmartEvent(string param)

{

if (!param.Contains(“,”))

{

Debug.Log(“[onNTSmartEvent] android传递参数错误”);

return;

}

string[] strs = param.Split(‘,’);

string player_handle =strs[0];

string code = strs[1];

string param1 = strs[2];

string param2 = strs[3];

string param3 = strs[4];

string param4 = strs[5];

Debug.Log(“[onNTSmartEvent] code: 0x” + Convert.ToString(Convert.ToInt32(code), 16));

switch (Convert.ToInt32(code))

{

case EVENTID.EVENT_DANIULIVE_ERC_PLAYER_STARTED:

Debug.Log(“开始。。”);

break;

case EVENTID.EVENT_DANIULIVE_ERC_PLAYER_CONNECTING:

Debug.Log(“连接中。。”);

break;

case EVENTID.EVENT_DANIULIVE_ERC_PLAYER_CONNECTION_FAILED:

Debug.Log(“连接失败。。”);

break;

case EVENTID.EVENT_DANIULIVE_ERC_PLAYER_CONNECTED:

Debug.Log(“连接成功。。”);

break;

case EVENTID.EVENT_DANIULIVE_ERC_PLAYER_DISCONNECTED:

Debug.Log(“连接断开。。”);

break;

case EVENTID.EVENT_DANIULIVE_ERC_PLAYER_STOP:

Debug.Log(“停止播放。。”);

break;

case EVENTID.EVENT_DANIULIVE_ERC_PLAYER_RESOLUTION_INFO:

Debug.Log(“分辨率信息: width: ” + Convert.ToInt32(param1) + “, height: ” + Convert.ToInt32(param2));

break;

case EVENTID.EVENT_DANIULIVE_ERC_PLAYER_NO_MEDIADATA_RECEIVED:

Debug.Log(“收不到媒体数据，可能是url错误。。”);

break;

case EVENTID.EVENT_DANIULIVE_ERC_PLAYER_SWITCH_URL:

Debug.Log(“切换播放URL。。”);

break;

 

case EVENTID.EVENT_DANIULIVE_ERC_PLAYER_CAPTURE_IMAGE:

Debug.Log(“快照: ” + param1 + ” 路径：” + param3);

 

if (Convert.ToInt32(param1) == 0)

{

Debug.Log(“截取快照成功。.”);

}

else

{

Debug.Log(“截取快照失败。.”);

}

break;

case EVENTID.EVENT_DANIULIVE_ERC_PLAYER_RECORDER_START_NEW_FILE:

Debug.Log(“[record]开始一个新的录像文件 : ” + param3);

break;

case EVENTID.EVENT_DANIULIVE_ERC_PLAYER_ONE_RECORDER_FILE_FINISHED:

Debug.Log(“[record]已生成一个录像文件 : ” + param3);

break;

case EVENTID.EVENT_DANIULIVE_ERC_PLAYER_START_BUFFERING:

Debug.Log(“Start_Buffering”);

break;

case EVENTID.EVENT_DANIULIVE_ERC_PLAYER_BUFFERING:

Debug.Log(“Buffering: ” + Convert.ToInt32(param1));

break;

case EVENTID.EVENT_DANIULIVE_ERC_PLAYER_STOP_BUFFERING:

Debug.Log(“Stop_Buffering”);

break;

case EVENTID.EVENT_DANIULIVE_ERC_PLAYER_DOWNLOAD_SPEED:

Debug.Log(“download_speed:” + param1 + “Byte/s” + “, ”

+ (Convert.ToInt32(param1) * 8 / 1000) + “kbps” + “, ” + (Convert.ToInt32(param1) / 1024)

+ “KB/s”);

break;

}

}

经测试，Android、iOS端效果如下，播放端延迟低于1秒，也可能是unity3d平台下最快最稳定的rtmp播放器/rtsp播放器：

视频效果图：

更多资料，可以访问 https://github.com/daniulive/SmarterStreaming or http://www.daniulive.com/