ScnLib_SetStreamingUrlA/W() | 标准版 | 专业版 | 超级版 | 游戏版 |
|---|
| C++ |
__declspec(dllimport) void __stdcall ScnLib_SetStreamingUrlA(LPCSTR pcszURL, LPCSTR pcszKey);
__declspec(dllimport) void __stdcall ScnLib_SetStreamingUrlW(LPCWSTR pcwszURL, LPCWSTR pcwszKey); |
✘ | ✔ | ✔ | ✔ |
| C# |
[DllImport("ScnLib.dll", CharSet = CharSet.Unicode)] public static extern void ScnLib_SetStreamingUrlW(string URL, string Key); |
| Basic |
Public Declare Unicode Sub ScnLib_SetStreamingUrlW Lib "ScnLib.dll" (ByVal URL As String, ByVal Key As String) |
| Delphi |
procedure ScnLib_SetStreamingUrlA(const URL: PAnsiChar; const Key: PAnsiChar); stdcall; external 'ScnLib.dll';
procedure ScnLib_SetStreamingUrlW(const URL: PWideChar; const Key: PWideChar); stdcall; external 'ScnLib.dll'; |
- 描述
设置直播推流地址。
- 参数
- URL [in]
直播推流地址。基于 RTMP/RTMPS 协议。设置零值或空字符串以禁用直播推流功能。典型的直播推流地址通常为以下格式：rtmp(s)://<media-server-address>[:port]/<application>/[appInstance]
其中：
- rtmp(s): 协议类型。对于 RTMP 协议使用“rtmp”；对于 RTMPS 协议使用“rtmps”。
- <media-server-address>: 流媒体服务器域名或 IP 地址。可以是互联网上某视频网站地址，或者本地局域网内某服务器地址。
- [:port]: TCP 连接端口。RTMP 的默认端口为 1935；RTMPS 的默认端口为 443。
- <application>: 应用名称。通常是公开的接入点标识。
- [appInstance]: 应用实例名称。通常是只有直播用户才知晓的私有推流密钥。
- Key [in]
直播推流密钥。通过此参数可单独传递直播推流密钥字符串作为应用实例名称。传递零值或空字符串则忽略此参数，URL参数即为完整直播推流地址。例如：
ScnLib_SetStreamingUrlA("rtmp://live.twitch.tv/app","live_84397912_jVSmpJOfADNXMCO9g1rziQbyVERdIf")
等效于
ScnLib_SetStreamingUrlA("rtmp://live.twitch.tv/app/live_84397912_jVSmpJOfADNXMCO9g1rziQbyVERdIf","")
- 返回值
无。
- 备注
调用该函数设置直播推流地址。SDK 支持通过 RTMP/RTMPS 协议将您的实时录屏视频直播推流到媒体服务器。一些视频直播网站（例如 Twitch）为您提供公共摄取服务器地址和私有推流密钥。摄取服务器地址对应 <media-server-address>，私有推流密钥对应 [appInstance]。Twitch 的直播推流地址可能如下所示：rtmp://live.twitch.tv/app/live_84397912_jVSmpJOfADNXMCO9g1rziQbyVERdIf
由于服务器端配置不同，不同网站/服务器的直播推流地址会有所不同。
默认设置下，SDK 直播推流地址设置为空，也就是不直播。如果要开启直播功能，需要在开始录制前调用该函数设置正确的直播推流地址。在录制过程中更改直播推流地址是允许的。要获取当前的直播推流地址，请调用 ScnLib_GetStreamingUrlA/W()。要检查直播推流是否正在运行，请调用 ScnLib_IsStreaming()。
- 参见
ScnLib_GetStreamingUrlA/W(), ScnLib_SetStreamingBitrate(), ScnLib_IsStreaming()
|