8c745d18e0
Some checks failed
dev release / build (push) Failing after 12s
Builds out the full v1 scope: a vendored+patched openscreen subset for low-latency Cast Streaming (Mirroring receiver 0F5096E8) alongside the existing Cast V2/HLS and new DLNA/AVTransport casting paths, breadcastd's Idle/Casting state machine with a private IPC socket, the breadcast GTK4 popup as a thin IPC client, and bread.cast.*/bread.command.cast.* breadd integration (device discovery, start/stop, mirroring lifecycle events). Also adds bakery/systemd/Forgejo CI packaging. Validated end-to-end against a real Chromecast/Google TV: negotiated Cast Streaming session, live pipeline playback, and daemon+GUI click-to-cast/ stop through the actual popup.
122 lines
5.3 KiB
C++
122 lines
5.3 KiB
C++
// Copyright 2015 The Chromium Authors
|
|
// Use of this source code is governed by a BSD-style license that can be
|
|
// found in the LICENSE file.
|
|
|
|
#ifndef CAST_STREAMING_PUBLIC_CONSTANTS_H_
|
|
#define CAST_STREAMING_PUBLIC_CONSTANTS_H_
|
|
|
|
////////////////////////////////////////////////////////////////////////////////
|
|
// NOTE: This file should only contain constants that are reasonably globally
|
|
// used (i.e., by many modules, and in all or nearly all subdirs). Do NOT add
|
|
// non-POD constants, functions, interfaces, or any logic to this module,
|
|
// except for std::ostream operators on an as-needed basis.
|
|
////////////////////////////////////////////////////////////////////////////////
|
|
|
|
#include <chrono>
|
|
#include <ostream>
|
|
#include <ratio>
|
|
|
|
namespace openscreen::cast {
|
|
|
|
// Default target playout delay. The playout delay is the window of time between
|
|
// capture from the source until presentation at the receiver.
|
|
inline constexpr std::chrono::milliseconds kDefaultTargetPlayoutDelay(400);
|
|
|
|
// Default UDP port, bound at the Receiver, for Cast Streaming. An
|
|
// implementation is required to use the port specified by the Receiver in its
|
|
// ANSWER control message, which may or may not match this port number here.
|
|
inline constexpr int kDefaultCastStreamingPort = 2344;
|
|
|
|
// Default TCP port, bound at the TLS server socket level, for Cast Streaming.
|
|
// An implementation must use the port specified in the DNS-SD published record
|
|
// for connecting over TLS, which may or may not match this port number here.
|
|
inline constexpr int kDefaultCastPort = 8010;
|
|
|
|
// Target number of milliseconds between the sending of RTCP reports. Both
|
|
// senders and receivers regularly send RTCP reports to their peer.
|
|
inline constexpr std::chrono::milliseconds kRtcpReportInterval(500);
|
|
|
|
// This is an important system-wide constant. This limits how much history
|
|
// the implementation must retain in order to process the acknowledgements of
|
|
// past frames.
|
|
//
|
|
// This value is carefully choosen such that it fits in the 8-bits range for
|
|
// frame IDs. It is also less than half of the full 8-bits range such that
|
|
// logic can handle wrap around and compare two frame IDs meaningfully.
|
|
inline constexpr int kMaxUnackedFrames = 120;
|
|
|
|
// The network must support a packet size of at least this many bytes.
|
|
inline constexpr int kRequiredNetworkPacketSize = 256;
|
|
|
|
// The spec declares RTP timestamps must always have a timebase of 90000 ticks
|
|
// per second for video.
|
|
inline constexpr int kRtpVideoTimebase = 90000;
|
|
|
|
// Minimum resolution is 320x240.
|
|
inline constexpr int kMinVideoHeight = 240;
|
|
inline constexpr int kMinVideoWidth = 320;
|
|
|
|
// The default frame rate for capture options is 30FPS.
|
|
inline constexpr int kDefaultFrameRate = 30;
|
|
|
|
// The mirroring spec suggests 300kbps as the absolute minimum bitrate.
|
|
inline constexpr int kDefaultVideoMinBitRate = 300 * 1000;
|
|
|
|
// Default video max bitrate is based on 1080P @ 30FPS, which can be played back
|
|
// at good quality around 10mbps.
|
|
inline constexpr int kDefaultVideoMaxBitRate = 10 * 1000 * 1000;
|
|
|
|
// The mirroring control protocol specifies 32kbps as the absolute minimum
|
|
// for audio. Depending on the type of audio content (narrowband, fullband,
|
|
// etc.) Opus specifically can perform very well at this bitrate.
|
|
// See: https://research.google/pubs/pub41650/
|
|
inline constexpr int kDefaultAudioMinBitRate = 32 * 1000;
|
|
|
|
// Opus generally sees little improvement above 192kbps, but some older codecs
|
|
// that we may consider supporting improve at up to 256kbps.
|
|
inline constexpr int kDefaultAudioMaxBitRate = 256 * 1000;
|
|
|
|
// While generally audio should be captured at the maximum sample rate, 16kHz is
|
|
// the recommended absolute minimum.
|
|
inline constexpr int kDefaultAudioMinSampleRate = 16000;
|
|
|
|
// The default audio sample rate is 48kHz, slightly higher than standard
|
|
// consumer audio.
|
|
inline constexpr int kDefaultAudioSampleRate = 48000;
|
|
|
|
// The default audio number of channels is set to stereo.
|
|
inline constexpr int kDefaultAudioChannels = 2;
|
|
|
|
// Default maximum delay for both audio and video. Used if the sender fails
|
|
// to provide any constraints.
|
|
inline constexpr std::chrono::milliseconds kDefaultMaxDelayMs(1500);
|
|
|
|
// TODO(issuetracker.google.com/184189100): As part of updating remoting
|
|
// OFFER/ANSWER and capabilities exchange, remoting version should be updated
|
|
// to 3.
|
|
inline constexpr int kSupportedRemotingVersion = 2;
|
|
|
|
// Used for RTCP message support.
|
|
constexpr uint32_t kCastName = ('C' << 24) + ('A' << 16) + ('S' << 8) + 'T';
|
|
|
|
// Codecs known and understood by cast senders and receivers. Note: receivers
|
|
// are required to implement the following codecs to be Cast V2 compliant: H264,
|
|
// VP8, AAC, Opus. Senders have to implement at least one codec from this
|
|
// list for audio or video to start a session.
|
|
// `kNotSpecified` is used in remoting to indicate that the stream is being
|
|
// remoted and is not specified as part of the OFFER message (indicated as
|
|
// "REMOTE_AUDIO" or "REMOTE_VIDEO").
|
|
enum class AudioCodec { kAac, kOpus, kNotSpecified };
|
|
|
|
enum class VideoCodec { kH264, kVp8, kHevc, kNotSpecified, kVp9, kAv1 };
|
|
std::ostream& operator<<(std::ostream& os, VideoCodec codec);
|
|
|
|
// The type (audio, video, or unknown) of the stream.
|
|
enum class StreamType { kUnknown, kAudio, kVideo };
|
|
|
|
enum class CastMode : uint8_t { kMirroring, kRemoting };
|
|
std::ostream& operator<<(std::ostream& os, CastMode mode);
|
|
|
|
} // namespace openscreen::cast
|
|
|
|
#endif // CAST_STREAMING_PUBLIC_CONSTANTS_H_
|