ScnLib_SetStreamingUrl()

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协议。设置为0值或空字符串以停用直播推流功能。直播推流地址通常遵循以下格式：
      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
    请注意，由于不同服务器的配置的差异，不同网站/服务器的直播推流地址可能会有所不同。

    默认情况下，直播推流地址为空字符串。要启用直播推流功能，请在开始录制前调用此函数设置有效的直播推流地址和密钥。在录制过程中更改直播推流地址是允许的。要获取当前的直播推流地址和密钥，请调用ScnLib_GetStreamingUrlA/W()。要检验直播推流是否正在进行，请调用ScnLib_IsStreaming()。

  • 参见
    ScnLib_GetStreamingUrlA/W()
    ScnLib_SetStreamingBitrate()
    ScnLib_IsStreaming()

下载 SDK API 总览