15821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Copyright (c) 2012 The Chromium Authors. All rights reserved. 25821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Use of this source code is governed by a BSD-style license that can be 35821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// found in the LICENSE file. 45821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 52a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)#ifndef MEDIA_AUDIO_CRAS_CRAS_INPUT_H_ 62a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)#define MEDIA_AUDIO_CRAS_CRAS_INPUT_H_ 75821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 85821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include <cras_client.h> 95821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 105821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include <string> 115821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 125821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include "base/compiler_specific.h" 1390dce4d38c5ff5333bea97d859d4e484e27edf0cTorne (Richard Coles)#include "media/audio/agc_audio_stream.h" 145821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include "media/audio/audio_io.h" 155821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include "media/audio/audio_parameters.h" 165821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 175821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)namespace media { 185821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 192a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)class AudioManagerCras; 205821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 215821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Provides an input stream for audio capture based on CRAS, the ChromeOS Audio 225821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Server. This object is not thread safe and all methods should be invoked in 235821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// the thread that created the object. 2490dce4d38c5ff5333bea97d859d4e484e27edf0cTorne (Richard Coles)class CrasInputStream : public AgcAudioStream<AudioInputStream> { 255821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) public: 265821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // The ctor takes all the usual parameters, plus |manager| which is the 275821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // audio manager who is creating this object. 28a36e5920737c6adbddd3e43b760e5de8431db6e0Torne (Richard Coles) CrasInputStream(const AudioParameters& params, AudioManagerCras* manager, 29a36e5920737c6adbddd3e43b760e5de8431db6e0Torne (Richard Coles) const std::string& device_id); 305821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 315821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // The dtor is typically called by the AudioManager only and it is usually 325821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // triggered by calling AudioOutputStream::Close(). 335821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) virtual ~CrasInputStream(); 345821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 355821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Implementation of AudioInputStream. 365821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) virtual bool Open() OVERRIDE; 375821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) virtual void Start(AudioInputCallback* callback) OVERRIDE; 385821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) virtual void Stop() OVERRIDE; 395821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) virtual void Close() OVERRIDE; 405821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) virtual double GetMaxVolume() OVERRIDE; 415821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) virtual void SetVolume(double volume) OVERRIDE; 425821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) virtual double GetVolume() OVERRIDE; 435821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 445821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) private: 455821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Handles requests to get samples from the provided buffer. This will be 465821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // called by the audio server when it has samples ready. 475821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) static int SamplesReady(cras_client* client, 485821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) cras_stream_id_t stream_id, 495821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) uint8* samples, 505821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) size_t frames, 515821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const timespec* sample_ts, 525821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) void* arg); 535821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 54010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) // Handles notification that there was an error with the playback stream. 555821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) static int StreamError(cras_client* client, 565821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) cras_stream_id_t stream_id, 575821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int err, 585821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) void* arg); 595821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 605821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Reads one or more buffers of audio from the device, passes on to the 615821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // registered callback. Called from SamplesReady(). 625821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) void ReadAudio(size_t frames, uint8* buffer, const timespec* sample_ts); 635821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 645821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Deals with an error that occured in the stream. Called from StreamError(). 655821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) void NotifyStreamError(int err); 665821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 675821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Convert from dB * 100 to a volume ratio. 685821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) double GetVolumeRatioFromDecibels(double dB) const; 695821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 705821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Convert from a volume ratio to dB. 715821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) double GetDecibelsFromVolumeRatio(double volume_ratio) const; 725821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 735821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Non-refcounted pointer back to the audio manager. 745821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // The AudioManager indirectly holds on to stream objects, so we don't 755821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // want circular references. Additionally, stream objects live on the audio 765821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // thread, which is owned by the audio manager and we don't want to addref 775821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // the manager from that thread. 78a36e5920737c6adbddd3e43b760e5de8431db6e0Torne (Richard Coles) AudioManagerCras* const audio_manager_; 795821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 805821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Size of frame in bytes. 815821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) uint32 bytes_per_frame_; 825821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 835821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Callback to pass audio samples too, valid while recording. 845821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) AudioInputCallback* callback_; 855821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 865821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // The client used to communicate with the audio server. 875821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) cras_client* client_; 885821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 895821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // PCM parameters for the stream. 90a36e5920737c6adbddd3e43b760e5de8431db6e0Torne (Richard Coles) const AudioParameters params_; 915821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 925821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // True if the stream has been started. 935821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) bool started_; 945821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 955821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // ID of the playing stream. 965821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) cras_stream_id_t stream_id_; 975821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 98a36e5920737c6adbddd3e43b760e5de8431db6e0Torne (Richard Coles) // Direction of the stream. 99a36e5920737c6adbddd3e43b760e5de8431db6e0Torne (Richard Coles) const CRAS_STREAM_DIRECTION stream_direction_; 100a36e5920737c6adbddd3e43b760e5de8431db6e0Torne (Richard Coles) 1016d86b77056ed63eb6871182f42a9fd5f07550f90Torne (Richard Coles) scoped_ptr<AudioBus> audio_bus_; 1026d86b77056ed63eb6871182f42a9fd5f07550f90Torne (Richard Coles) 1035821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) DISALLOW_COPY_AND_ASSIGN(CrasInputStream); 1045821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}; 1055821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1065821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} // namespace media 1075821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1085d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles)#endif // MEDIA_AUDIO_CRAS_CRAS_INPUT_H_ 109