2.1 demo说明

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

2.2 功能说明

标准接口：

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

增值接口：

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

2.3 集成说明

拷贝以下文件，到Assets–>Plugins–>iOS目录：

相关头文件和调用说明，参见：SmartPlayeriOSMono.cs

Unity3D工程下，File–>Build Settings，Platform选择iOS，然后点击build，设置目录，生成xcode工程：

生成后的xcode工程，添加以下依赖库：

• 相关库：libSmartPlayerSDK.a
• 引入以下依赖framework
  • libz.tbd
  • libbz2.tbd
  • libiconv.tbd
  • libstdc++.tbd
  • libc++.tbd
  • Accelerate.framework
  • AssetsLibrary.framework
  • AudioToolBox.framework
  • AVFoundation.framework
  • CoreMedia.framework
  • Foundation.framework
  • GLKit.framework
  • OpenGLES.framework
  • UIKit.framework
  • VideoToolBox.framework
• 如需集成到自己系统测试，请用大牛直播的app name:

Info.plist–>右键Open As–>Source Code

添加或者编辑

<key>CFBundleName</key>

<string>SmartiOSPlayer</string>

• 快照添加到“照片”权限:

Info.plist–>右键Open As–>Source Code

添加

<key>NSPhotoLibraryUsageDescription</key>
<string>1</string>

• 导出后的xcode工程，如编译不过，参考以下设置: Library Search Paths：$(SRCROOT)/Libraries

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

2.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;

}

}

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