• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1 // Copyright 2013 The Chromium Authors. All rights reserved.
2 // Use of this source code is governed by a BSD-style license that can be
3 // found in the LICENSE file.
4 //
5 // This is the main interface for the cast sender.
6 //
7 // The AudioFrameInput, VideoFrameInput and PacketReciever interfaces should
8 // be accessed from the main thread.
9 
10 #ifndef MEDIA_CAST_CAST_SENDER_H_
11 #define MEDIA_CAST_CAST_SENDER_H_
12 
13 #include "base/basictypes.h"
14 #include "base/callback.h"
15 #include "base/memory/ref_counted.h"
16 #include "base/memory/scoped_ptr.h"
17 #include "base/time/tick_clock.h"
18 #include "base/time/time.h"
19 #include "media/base/audio_bus.h"
20 #include "media/cast/cast_config.h"
21 #include "media/cast/cast_environment.h"
22 #include "media/cast/net/cast_transport_sender.h"
23 
24 namespace media {
25 class VideoFrame;
26 
27 namespace cast {
28 class AudioSender;
29 class VideoSender;
30 
31 class VideoFrameInput : public base::RefCountedThreadSafe<VideoFrameInput> {
32  public:
33   // Insert video frames into Cast sender. Frames will be encoded, packetized
34   // and sent to the network.
35   virtual void InsertRawVideoFrame(
36       const scoped_refptr<media::VideoFrame>& video_frame,
37       const base::TimeTicks& capture_time) = 0;
38 
39  protected:
~VideoFrameInput()40   virtual ~VideoFrameInput() {}
41 
42  private:
43   friend class base::RefCountedThreadSafe<VideoFrameInput>;
44 };
45 
46 class AudioFrameInput : public base::RefCountedThreadSafe<AudioFrameInput> {
47  public:
48   // Insert audio frames into Cast sender. Frames will be encoded, packetized
49   // and sent to the network.
50   virtual void InsertAudio(scoped_ptr<AudioBus> audio_bus,
51                            const base::TimeTicks& recorded_time) = 0;
52 
53  protected:
~AudioFrameInput()54   virtual ~AudioFrameInput() {}
55 
56  private:
57   friend class base::RefCountedThreadSafe<AudioFrameInput>;
58 };
59 
60 // All methods of CastSender must be called on the main thread.
61 // Provided CastTransportSender will also be called on the main thread.
62 class CastSender {
63  public:
64   static scoped_ptr<CastSender> Create(
65       scoped_refptr<CastEnvironment> cast_environment,
66       CastTransportSender* const transport_sender);
67 
~CastSender()68   virtual ~CastSender() {}
69 
70   // All video frames for the session should be inserted to this object.
71   virtual scoped_refptr<VideoFrameInput> video_frame_input() = 0;
72 
73   // All audio frames for the session should be inserted to this object.
74   virtual scoped_refptr<AudioFrameInput> audio_frame_input() = 0;
75 
76   // Initialize the audio stack. Must be called in order to send audio frames.
77   // Status of the initialization will be returned on cast_initialization_cb.
78   virtual void InitializeAudio(
79       const AudioSenderConfig& audio_config,
80       const CastInitializationCallback& cast_initialization_cb) = 0;
81 
82   // Initialize the video stack. Must be called in order to send video frames.
83   // Status of the initialization will be returned on cast_initialization_cb.
84   virtual void InitializeVideo(
85       const VideoSenderConfig& video_config,
86       const CastInitializationCallback& cast_initialization_cb,
87       const CreateVideoEncodeAcceleratorCallback& create_vea_cb,
88       const CreateVideoEncodeMemoryCallback& create_video_encode_mem_cb) = 0;
89 
90   // Change the target delay. This is only valid if the receiver
91   // supports the "adaptive_target_delay" rtp extension.
92   virtual void SetTargetPlayoutDelay(
93       base::TimeDelta new_target_playout_delay) = 0;
94 };
95 
96 }  // namespace cast
97 }  // namespace media
98 
99 #endif  // MEDIA_CAST_CAST_SENDER_H_
100