receiver_slot.h

Go to the documentation of this file.

/*
 * Copyright (c) 2020 Roc Streaming authors
 *
 * This Source Code Form is subject to the terms of the Mozilla Public
 * License, v. 2.0. If a copy of the MPL was not distributed with this
 * file, You can obtain one at http://mozilla.org/MPL/2.0/.
 */
 
//! @file roc_pipeline/receiver_slot.h
//! @brief Receiver slot.
 
#ifndef ROC_PIPELINE_RECEIVER_SLOT_H_
#define ROC_PIPELINE_RECEIVER_SLOT_H_
 
#include "roc_address/interface.h"
#include "roc_address/protocol.h"
#include "roc_audio/mixer.h"
#include "roc_core/iarena.h"
#include "roc_core/list.h"
#include "roc_core/list_node.h"
#include "roc_core/ref_counted.h"
#include "roc_packet/packet_factory.h"
#include "roc_pipeline/metrics.h"
#include "roc_pipeline/receiver_endpoint.h"
#include "roc_pipeline/receiver_session_group.h"
#include "roc_pipeline/receiver_state.h"
#include "roc_rtp/format_map.h"
 
namespace roc {
namespace pipeline {
 
//! Receiver slot.
//!
//! Contains:
//!  - one or more related receiver endpoints, one per each type
//!  - one session group associated with those endpoints
class ReceiverSlot : public core::RefCounted<ReceiverSlot, core::ArenaAllocation>,
                     public core::ListNode {
public:
    //! Initialize.
    ReceiverSlot(const ReceiverConfig& receiver_config,
                 ReceiverState& receiver_state,
                 audio::Mixer& mixer,
                 const rtp::FormatMap& format_map,
                 packet::PacketFactory& packet_factory,
                 core::BufferFactory<uint8_t>& byte_buffer_factory,
                 core::BufferFactory<audio::sample_t>& sample_buffer_factory,
                 core::IArena& arena);
 
    //! Add endpoint.
    ReceiverEndpoint* add_endpoint(address::Interface iface, address::Protocol proto);
 
    //! Pull packets and refresh sessions according to current time.
    //! @returns
    //!  deadline (absolute time) when refresh should be invoked again
    //!  if there are no frames
    core::nanoseconds_t refresh(core::nanoseconds_t current_time);
 
    //! Adjust sessions clock to match consumer clock.
    //! @remarks
    //!  @p playback_time specified absolute time when first sample of last frame
    //!  retrieved from pipeline will be actually played on sink
    void reclock(core::nanoseconds_t playback_time);
 
    //! Get number of alive sessions.
    size_t num_sessions() const;
 
    //! Get metrics for slot and its sessions.
    void get_metrics(ReceiverSlotMetrics& slot_metrics,
                     ReceiverSessionMetrics* sess_metrics,
                     size_t* sess_metrics_size) const;
 
private:
    ReceiverEndpoint* create_source_endpoint_(address::Protocol proto);
    ReceiverEndpoint* create_repair_endpoint_(address::Protocol proto);
    ReceiverEndpoint* create_control_endpoint_(address::Protocol proto);
 
    const rtp::FormatMap& format_map_;
 
    ReceiverState& receiver_state_;
    ReceiverSessionGroup session_group_;
 
    core::Optional<ReceiverEndpoint> source_endpoint_;
    core::Optional<ReceiverEndpoint> repair_endpoint_;
    core::Optional<ReceiverEndpoint> control_endpoint_;
};
 
} // namespace pipeline
} // namespace roc
 
#endif // ROC_PIPELINE_RECEIVER_SLOT_H_