Live Video on Workplace

Broadcast production-quality video securely to anyone in your Workplace community, whether in the office or on the go.

Quick Start Guide

If you're new to live streaming on Workplace, there are a few things you'll need to know to get started live streaming. Everything from initiating a new broadcast to using the Graph API to monitor viewers will be covered in this Live API tutorial. To broadcast in Workplace using professional AV equipment, you'll need to use the live create panel following these steps.

Start a new Live broadcast from https://work.facebook.com/live/create
In most cases, you'll want to broadcast your event into a Workplace group. Input the group's name and click Next.
Configure your encoder with the generated Server URL and Stream Key and start streaming from your encoder. The steps to configure and start broadcasting vary by encoder, so read your encoder's documentation for instructions.
The Go Live button will become enabled when Workplace begins receiving video from your encoder. Add a description of your broadcast and click the Go Live button to start your broadcast.

If the Go Live button is not enabled, Workplace is not receiving video from your encoder. Check your encoder's configuration and make sure you have started streaming.

While your event is underway, you'll see comments and reactions from viewers in this panel. You can interact with viewers by replying to their comments or pinning a comment to keep it visible to all viewers. When your event is done, click End Live Video to stop broadcasting.
After your event is finished, Workplace will make a video-on-demand version available for people who were not able to watch live.

Technical Specifications

To ensure premium quality live streams, please follow our technical specifications and streaming recommendations:

Video Format:

  • We accept video in maximum 1080p (1920x1080) resolution at 30 frames per second, with 1 key frame every 2 seconds.
  • You must send an I-frame (keyframe) at least once every two seconds throughout the stream.
  • Recommended max bit rate is 4 Mbps. Going above this maximum is possible but will make live streams highly unstable.
  • Titles must be less than 255 characters otherwise the stream will fail
  • The Live API accepts H264 encoded video and AAC encoded audio only

Video Length:

  • 4 hour maximum length for live stream.
  • 4 hour maximum length for preview streams (either through Live dialog or publisher tools). After 240 minutes, a new stream key must be generated.
  • RTMP stream URLs will expire 24 hours after they are created.

Advanced Audio Settings:

  • Audio Sample Rate: 48 KHz
  • Audio Bitrate: 128 Kbps mono

Advanced Video Settings:

  • Pixel Aspect Ratio: Square
  • Frame Types: Progressive Scan
  • Bitrate Encoding: CBR

Playback of live content will only work if the input broadcast has both an audio and a video track.

Tips for High Stakes Events

Hire experts

Live streaming is not new, and there are many experienced production teams who can work through the creative and technical challenges.

Use a hardware encoder

All other things being equal, hardware encoders tend to be more reliable and deliver higher-quality results.

Follow our encoding specs precisely

Always configure your encoder to send video and audio exactly as specified by Workplace.

Establishing a reliable internet connection is essential

We recommend using wired connections whenever possible - you should have 8 Mbps sustained and dedicated upload capacity. If you must use Wi-Fi, make sure it’s secured and dedicated for the broadcast.

Test ahead of time

The more complex the setup, the more planning and testing is needed. Create a group that you can use to test your broadcast configuration.

Build a tight run of show and scripts

Rehearse your show. Prep your talent and walk them through the whole production. Everyone needs to rehearse. Leave as little to chance as you can.

Think about lighting and audio even in simple configurations

Dim light will kill your video quality. Background noise or wind will make audio hard to understand.

Workplace Live Partners

Workplace Live video partners can supply you with equipment, technology, and services to enable high-quality Live broadcast results.

Video Equipment and Hardware Encoders

PartnerServices

Advanced Systems Group LLC of Emeryville, Calif., has provided engineering, systems, integration, support and training to the broadcast, film, creative and corporate video markets since 1997

Blackmagic Design creates the world’s highest quality video editing products, digital film cameras, color correctors, video converters, video monitoring, routers, live production switchers, disk recorders, waveform monitors and real time film scanners. Blackmagic Design has offices in the USA, UK, Japan, Singapore and Australia.

Elemental Live provides real-time video and audio encoding for linear TV broadcast and live streaming to new media platforms. The software-based solution simultaneously processes multiple video outputs, delivering high-quality, high-efficiency performance to format live video for any device.

Create better and more engaging Workplace videos with Epiphan Video. Epiphan builds everything from capture cards to professional video mixers and streamers to deliver the best live video experience.

Haivision video streaming on Workplace helps companies broadcast high quality live video to employees on any device, anywhere. The Haivision KB encoder supports RTMPS webcasting.

Teradek encoders help you stream live on Facebook from your camera, video switcher, or 360º VR rig, allowing you to engage with your colleagues, clients, friends, and followers from anywhere in the world.

Streaming Technology and Software

PartnerServices

BlueJeans is the world’s leading provider of interoperable video communication, bringing video to you wherever you are.

Open Broadcaster Software (OBS) is free and open source software for video recording and live streaming. Download and start streaming quickly and easily on Windows, Mac or Linux.

StreamShark helps deliver the highest quality live stream experience for CEO Townhalls, All Hands meetings, celebrities, brands and everything in between with unparalleled reliability, security and redundancy.

Wowza is a Facebook certified and approved encoding and streaming partner for Enterprises looking to ensure the highest-quality stream delivery through Workplace by Facebook, enabling intelligent stream monitoring and minimizing connection and streaming issues.

Production Services

PartnerServices

Since 1976 All Mobile Video has been committed to supplying technology solutions, innovation and integrated resources for our clients successes all over the world. Services include Mobile Production Units, Sound Stages, Transmission, Encoding, Post-Production, Crewing and Payroll, Equipment Sales, Rentals and Centralized Master Control.

Groovy Gecko are using the skills and processes they have developed over the last four years working with Facebook to help organizations deliver high quality live video content to their internal audiences through Workplace. GG offer a fully managed and delivered live streaming service covering all elements including video production, live encoders and engineers and access to the Groovy Gecko FB Live console which allows the delivery of interactive elements such as moderated Q&A and audience polling.

Live Media Group is a complete turnkey partner for our clients in the live broadcast space. With thousands of live events under our belt, our turnkey solution means we manage every aspect of a live production, from the initial concept through final live broadcast delivery to web, mobile and OTT. This ensures the highest quality product and experience for our client partners and their viewers.

Pixel Corps specializes in feature rich, mission critical, livestreaming solutions for entertainment, corporate, and government clients. Pixel Corps has delivered thousands of successful webcasts for customers over the past five years with exceptional quality and reliability.

Troubleshooting

Due to the complex nature of live streaming, often times there may be issues along the way that prevent you from going live. Regardless of if you're live streaming through your page's Publisher Tools or with the Live API, below are some common issues that you may face and how to solve them:

Understanding Potential Live Video Issues:

  1. Why doesn't my live video play on mobile web (i.e. Safari on an iPhone)?

    • Live video is not currently supported in mobile web. Once the live video is no longer live, the VOD (video on demand) will be able to be viewed in mobile web browsers.
  2. My live video is still showing up as 'is live' even though it ended awhile ago? What happened?

    • This occurs when the broadcast does not start sealing or processing after signaling the end of the live. Be sure you have either sent a POST request with the end_live_video parameter or clicked 'End Live' through the Publisher Tools UI. If this occurs again, please file a bug in our bug tool and be sure to include your video ID.
  3. What does this error code mean?

    • If you have received an error code from the Live API, be sure to check our list of error codes to best understand the issue.
  4. The audio on my Facebook Live video has either begun to skip and chatter or drop out completely. What's going on?

    • Audio distortion can occur when Facebook receives a video stream with distorted audio or after we've received the frames but before we re-encode for broadcast. A possible reason for this type of error is if the bitrate used is higher than the connection between your broadcasting endpoint and what Facebook servers can sustain. If that happens or if there's a packet lost, some of the video or audio track won't be received correctly and result in audio distortion.
  5. Why are the video and audio out of sync on my live video?

    • A/V sync issues may occur when a live broadcast is delivered with limited bandwidth to the client, or the client does not have the bandwidth to view it during live. Additionally, if the stream received by the Facebook server is out of sync, then the live video will also be out of sync. Be sure to check recording and encoding hardware for potential places in which the audio could be misaligned with the video.
  6. I'm trying steam video without audio. Why doesn't it work?

    • The Live API requires audio. It you attempt to stream video only, the stream ends.
  7. What happens if my live feed drops?

    • Your live feed may drop due to an encoder failure or poor network connectivity. If this happens, you have 2-3 minutes to reconnect to the original stream url that you generated for your live post. Otherwise, you will have to generate a new stream key and url to continue your live stream.

FAQ

For the broadcast (upload) side, Workplace Live video streams use about 4.0 Mbps. For the viewer (download) side, the bandwidth consumed is proportional to the number of concurrent viewers on your network. As a rough estimation factor, you can plan for 2.0 Mbps required for each viewer of a high-quality stream, although the Workplace viewer can use a lower bitrate with lower video quality as required by network conditions.

Workplace recommends using RTMPS (RTMP over SSL) to protect the confidentiality of your video broadcast; the control panel will generate an RTMPS URL by default. If your encoder does not support RTMPS, you can uncheck the box "Secure Connection (SSL)", which will cause the broadcast URL to RTMP.

Encoders that support RTMPS today include Wowza Streaming Engine and Haivision KB. It is also possible to add RTMPS support to OBS by compiling it yourself with OpenSSL.