Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
en:services:mobile_working:live_streaming:start [2021/08/03 11:05] – [Troubleshooting and F.A.Q] mhellka | en:services:mobile_working:live_streaming:start [2024/07/05 16:51] (current) – [Troubleshooting and F.A.Q] mhellka | ||
---|---|---|---|
Line 1: | Line 1: | ||
+ | |||
+ | ====== Live-Streaming ====== | ||
+ | |||
+ | The GWDG live-streaming infrastructure makes it possible to broadcast lectures, conferences or other live-events to large audiences and offers an alternative or addition to [[en: | ||
+ | |||
+ | <WRAP round important> | ||
+ | This service is still in development and offered "as is", primarily for testing purposes. If you plan large conferences or events, please [[support@gwdg.de|tell us]] in advance so we can plan accordingly. | ||
+ | </ | ||
+ | ===== Getting started ===== | ||
+ | |||
+ | To start streaming, you need a channel and a channel-secret. Please file a [[support@gwdg.de|support ticket]] to request your channel credentials and tell us your preferred channel name. Once the channel is created, you can follow the instructions or tutorials matching your recording tool of choice and start streaming. | ||
+ | |||
+ | ^ Setting | ||
+ | | **Stream-URL** | ||
+ | | **Stream-Key** | ||
+ | | **Player URL** | '' | ||
+ | |||
+ | Some tools combine stream-server and stream-key into a single URL:\\ | ||
+ | '' | ||
+ | |||
+ | ==== Named streams ==== | ||
+ | You can publish more than one stream at the same time or create private streams by appending a unique stream name to the channel part of your stream-key. Channel and stream name are separated by a colon (e.g. ''< | ||
+ | |||
+ | **Example: | ||
+ | |||
+ | ==== Stream profiles ==== | ||
+ | |||
+ | The streaming server will automatically downscale submitted video to 720p (1280×720, 30fps) if necessary. Higher or lower video profiles can be selected by adding a ''& | ||
+ | |||
+ | ^ Profile | ||
+ | | '' | ||
+ | | '' | ||
+ | | '' | ||
+ | | '' | ||
+ | |||
+ | The profile should match the resolution and framerate of the transmitted stream as closely as possible to avoid unnecessary down-scaling or frame-dropping on server side. Higher profiles may not be available to all channels. If the selected | ||
+ | |||
+ | **Example: | ||
+ | |||
+ | === Adaptive Bitrate Streaming === | ||
+ | |||
+ | Some profiles can be combined with [[https:// | ||
+ | |||
+ | To enable " | ||
+ | |||
+ | ===== Streaming guides ===== | ||
+ | |||
+ | ==== OBS Studio ==== | ||
+ | |||
+ | [[https:// | ||
+ | |||
+ | ==== BigBlueButton === | ||
+ | |||
+ | [[https:// | ||
+ | |||
+ | ==== Zoom ==== | ||
+ | |||
+ | Zoom allows direct streaming of meetings, but the feature is disabled by default. Follow the [[https:// | ||
+ | |||
+ | Warning: Zoom relies heavily on cloud-resources outside of the EU to record and stream your meetings, even if your account is ' | ||
+ | |||
+ | ==== Cisco Webex ==== | ||
+ | |||
+ | If live-streaming is enabled for your paid Webex Meetings or Events plan, you can stream directly from within Webex. No additional software required. Details can be found in [[https:// | ||
+ | |||
+ | ===== Troubleshooting and F.A.Q ===== | ||
+ | |||
+ | __** What software to use?**__ | ||
+ | |||
+ | * Any software that supports RTMP will work. We recommend [[https:// | ||
+ | |||
+ | __**The stream does not connect, or disconnects immediately**__ | ||
+ | |||
+ | * Make sure your stream key is correct. Both channel and secret are case-sensitive. Make sure all stream-key properties (e.g. '' | ||
+ | * Stream names must be unique. If there is a running stream with the same channel and stream-name, | ||
+ | * The stream key may be locked. Please contact support. | ||
+ | * The system may be overloaded or you may have triggered a bug. Please contact support, we can look into the logs and find out the cause. | ||
+ | |||
+ | __**The stream disconnects after approximately 10 seconds**__ | ||
+ | |||
+ | * There seems to be a problem with the submitted video stream. OBS usually does the right thing and default settings work out of the box. Low-level tools however (e.g. ffmpeg) may produce invalid streams if used incorrectly. | ||
+ | * The stream must begin with video data available. Audio-only streams are not supported. Timestamp correction (e.g. to fix audio/video synchronisation issues) may cause video to arrive late, and not being detected correctly. | ||
+ | * Transcoding can only begin at key-frame (I-frame) borders. Make sure the video stream contains at least one key-frame every 4 seconds. | ||
+ | * If '' | ||
+ | * The system may be overloaded, a worker process may have crashed or you may have triggered a bug. Please try to reconnect and contact support if the issue persists. | ||
+ | |||
+ | __**How to reduce video delay?**__ | ||
+ | |||
+ | * A delay of 6-10 seconds is normal. Larger delays are usually caused by buffering within the streaming software. | ||
+ | |||
+ | __**Viewers complain about buffering**__ | ||
+ | |||
+ | * The maximum bandwidth required for viewing a stream depends on the selected stream profile. Try a profile with a lower bitrate or enable ABR (adaptive bitrate streaming) if a lot of your viewers depend on mobile or unreliable networks. | ||
+ | * Occasional buffering at the beginning of a stream is normal, as the clients need to calculate a sensible buffer size first. If image complexity changes drastically (e.g. switching from a mostly static scene to rapid movement) then this calculation may be off. Unstable networks with varying bandwidth have the same effect. The stream usually runs well after a while, once the client has increased its buffer size. | ||
+ | * Video data contains timing information and correct timing is essential for a live-stream. Broken equipment, high CPU load, bad source video files or wrong encoding parameters may result in frames being sent out of order, too fast, too slow, or with gaps. The player will then struggle playing a continuous stream or even give up and stop entirely. When streaming a pre-recorded video, make sure to send data in real-time and not faster. For '' | ||
+ | * Our current infrastructure can handle 2000 to 4000 concurrent viewers in total, depending on stream profile and content. This is an untested theoretical limit, though. If you are expecting close to or more than a thousand viewers, please tell us in advance and be prepared for technical difficulties. We are still in testing phase and do not have experience yet with exceptionally large audiences. | ||
+ | |||
+ | __**Video skips or jumps forward in time**__ | ||
+ | |||
+ | * When streaming a pre-recorded video, make sure to send data in real-time and not faster. For '' | ||
+ | |||
+ | __**Video quality is bad**__ | ||
+ | |||
+ | * Video quality should be good enough for most use cases, even on low stream profiles. If your stream looks blurry or distorted, please first make sure that your streaming software sends video with high-enough quality to begin with. Dropped frames or bad video quality may also be caused by an overloaded streaming PC or network connection. | ||
+ | * Rapid movement and complex scenes (e.g. fast paced games) do not compress very well and may appear blurry if they hit the profile-specific maximum bitrate limit. This is normal. The default stream profiles are optimized for lectures or presentations with mostly static content. Choose a higher bitrate stream profile if available, or tell us about your use-case. Non-public stream profiles with even higher quality settings are available on request. | ||
+ | |||
+ | __**Audio and video is out of sync**__ | ||
+ | |||
+ | * This is usually caused by the streaming software sending out-of-sync data. We cannot fix that on our side. | ||
+ | |||
+ | __**Audio is in wrong language**__ | ||
+ | |||
+ | * When streaming a video that contains more than one audio track, all but the first track are ignored. Multi-track audio is not supported (yet). | ||
+ | |||
+ | __**Video won't play on some devices**__ | ||
+ | |||
+ | * Live streams are published as '' | ||
+ | |||
+ | __**Is there a way to start video playback automatically (autoplay)? | ||
+ | |||
+ | * No. Modern browsers block autoplay unless the video is muted or the user explicitly allowed a website to autoplay video. | ||
+ | |||
+ | __**Are live-streams recorded? Can I get a recoding of a past live-stream? | ||
+ | |||
+ | * No. Life-streams are encoded in real-time and split into small chunks, usually 2 seconds in length. We only keep a certain number of these chunks available for video-players to download and people to watch. Older chunks are deleted as soon as they fall out of the configured time-window. After a stream ends, all remaining audio and video data is removed quickly. | ||
+ | * If you want to record a stream, we strongly suggest to do that directly on the streaming PC. Most software (e.g. OBS) can stream and record at the same time with little overhead. This also reduces the risk of network problems affecting the recording quality in a negative way. | ||
+ | * We of cause cannot prevent viewers from recording a live-stream while it is streamed. | ||
+ | |||
+ | __**What does this service cost?**__ | ||
+ | |||
+ | * During the testing phase, no costs are attached to this service. Moderate usage will be most likely continue to be free for our customers, including AcademicCloud partners. | ||
+ | |||
+ | ===== Datenschutzerklärung (German only) ===== | ||
+ | |||
+ | Der Dienst verarbeitet keine Personenbezogenen Daten mit Ausnahme von IP-Adressen, | ||
+ | |||