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) 55821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#ifndef MEDIA_BASE_AUDIO_DECODER_H_ 65821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define MEDIA_BASE_AUDIO_DECODER_H_ 75821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 85821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include "base/callback.h" 95821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include "base/memory/ref_counted.h" 105821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include "media/base/channel_layout.h" 115821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include "media/base/pipeline_status.h" 125821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include "media/base/media_export.h" 135821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 145821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)namespace media { 155821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 167dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdochclass AudioBuffer; 175821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)class DemuxerStream; 185821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 192a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)class MEDIA_EXPORT AudioDecoder { 205821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) public: 215821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Status codes for read operations. 225821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) enum Status { 235821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) kOk, 245821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) kAborted, 255821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) kDecodeError, 265821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) }; 275821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 282a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) AudioDecoder(); 292a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) virtual ~AudioDecoder(); 302a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) 315821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Initialize an AudioDecoder with the given DemuxerStream, executing the 325821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // callback upon completion. 335821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // statistics_cb is used to update global pipeline statistics. 34c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) virtual void Initialize(DemuxerStream* stream, 355821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const PipelineStatusCB& status_cb, 365821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const StatisticsCB& statistics_cb) = 0; 375821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 385821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Request samples to be decoded and returned via the provided callback. 395821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Only one read may be in flight at any given time. 405821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // 415821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Implementations guarantee that the callback will not be called from within 425821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // this method. 435821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // 445821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Non-NULL sample buffer pointers will contain decoded audio data or may 455821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // indicate the end of the stream. A NULL buffer pointer indicates an aborted 465821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Read(). This can happen if the DemuxerStream gets flushed and doesn't have 475821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // any more data to return. 487dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch typedef base::Callback<void(Status, const scoped_refptr<AudioBuffer>&)> 497dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch ReadCB; 505821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) virtual void Read(const ReadCB& read_cb) = 0; 515821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 525821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Reset decoder state, dropping any queued encoded data. 535821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) virtual void Reset(const base::Closure& closure) = 0; 545821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 555821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Returns various information about the decoded audio format. 565821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) virtual int bits_per_channel() = 0; 575821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) virtual ChannelLayout channel_layout() = 0; 585821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) virtual int samples_per_second() = 0; 595821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 602a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) private: 615821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) DISALLOW_COPY_AND_ASSIGN(AudioDecoder); 625821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}; 635821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 645821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} // namespace media 655821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 665821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#endif // MEDIA_BASE_AUDIO_DECODER_H_ 67