Chromium Code Reviews
chromiumcodereview-hr@appspot.gserviceaccount.com (chromiumcodereview-hr) | Please choose your nickname with Settings | Help | Chromium Project | Gerrit Changes | Sign out
(681)

Side by Side Diff: components/copresence/public/whispernet_client.h

Issue 637223011: Redesign the copresence audio handlers. (Closed) Base URL: https://chromium.googlesource.com/chromium/src.git/+/master
Patch Set: Created 6 years, 2 months ago
Use n/p to move between diff chunks; N/P to move between comments. Draft comments are only viewable by you.
Jump to:
View unified diff | Download patch
OLDNEW
1 // Copyright 2014 The Chromium Authors. All rights reserved. 1 // Copyright 2014 The Chromium Authors. All rights reserved.
2 // Use of this source code is governed by a BSD-style license that can be 2 // Use of this source code is governed by a BSD-style license that can be
3 // found in the LICENSE file. 3 // found in the LICENSE file.
4 4
5 #ifndef COMPONENTS_COPRESENCE_PUBLIC_WHISPERNET_CLIENT_H_ 5 #ifndef COMPONENTS_COPRESENCE_PUBLIC_WHISPERNET_CLIENT_H_
6 #define COMPONENTS_COPRESENCE_PUBLIC_WHISPERNET_CLIENT_H_ 6 #define COMPONENTS_COPRESENCE_PUBLIC_WHISPERNET_CLIENT_H_
7 7
8 #include <string> 8 #include <string>
9 #include <vector> 9 #include <vector>
10 10
11 #include "base/callback.h" 11 #include "base/callback.h"
12 #include "base/macros.h" 12 #include "base/macros.h"
13 #include "base/memory/ref_counted.h" 13 #include "base/memory/ref_counted.h"
14 #include "components/copresence/public/copresence_constants.h"
14 15
15 namespace media { 16 namespace media {
16 class AudioBusRefCounted; 17 class AudioBusRefCounted;
17 } 18 }
18 19
19 namespace copresence { 20 namespace copresence {
20 21
21 struct AudioToken { 22 struct AudioToken {
22 AudioToken(const std::string& token, bool audible) 23 AudioToken(const std::string& token, bool audible)
23 : token(token), audible(audible) {} 24 : token(token), audible(audible) {}
24 std::string token; 25 std::string token;
25 bool audible; 26 bool audible;
26 }; 27 };
27 28
28 // The interface that the whispernet client needs to implement. These methods 29 // The interface that the whispernet client needs to implement. These methods
29 // provide us the ability to use the audio medium in copresence. Currently since 30 // provide us the ability to use the audio medium in copresence. Currently since
30 // the only medium that copresence uses is audio, the implementation of this 31 // the only medium that copresence uses is audio, the implementation of this
31 // interface is required. 32 // interface is required.
32 class WhispernetClient { 33 class WhispernetClient {
33 public: 34 public:
34 // Generic callback to indicate a boolean success or failure. 35 // Generic callback to indicate a boolean success or failure.
35 typedef base::Callback<void(bool)> SuccessCallback; 36 typedef base::Callback<void(bool)> SuccessCallback;
36 // Callback that returns detected tokens. 37 // Callback that returns detected tokens.
37 typedef base::Callback<void(const std::vector<AudioToken>&)> TokensCallback; 38 typedef base::Callback<void(const std::vector<AudioToken>&)> TokensCallback;
38 // Callback that returns encoded samples for a given token. 39 // Callback that returns encoded samples for a given token.
39 typedef base::Callback<void(const std::string&, 40 typedef base::Callback<void(const std::string&,
40 bool, 41 AudioType,
41 const scoped_refptr<media::AudioBusRefCounted>&)> 42 const scoped_refptr<media::AudioBusRefCounted>&)>
42 SamplesCallback; 43 SamplesCallback;
43 44
44 // Initialize the whispernet client and call the callback when done. The 45 // Initialize the whispernet client and call the callback when done. The
45 // parameter indicates whether we succeeded or failed. 46 // parameter indicates whether we succeeded or failed.
46 virtual void Initialize(const SuccessCallback& init_callback) = 0; 47 virtual void Initialize(const SuccessCallback& init_callback) = 0;
47 // Copresence will call this before making any calls to its destructors. 48 // Copresence will call this before making any calls to its destructors.
48 virtual void Shutdown() = 0; 49 virtual void Shutdown() = 0;
49 50
50 // Fires an event to request a token encode. 51 // Fires an event to request a token encode.
51 virtual void EncodeToken(const std::string& token, bool audible) = 0; 52 virtual void EncodeToken(const std::string& token, AudioType type) = 0;
52 // Fires an event to request a decode for the given samples. 53 // Fires an event to request a decode for the given samples.
53 virtual void DecodeSamples(const std::string& samples) = 0; 54 virtual void DecodeSamples(AudioType type, const std::string& samples) = 0;
54 // Fires an event to request detection of a whispernet broadcast. 55 // Fires an event to request detection of a whispernet broadcast.
55 virtual void DetectBroadcast() = 0; 56 virtual void DetectBroadcast() = 0;
56 57
57 // Callback registreation methods. These are the callbacks that will be 58 // Callback registreation methods. These are the callbacks that will be
58 // registered by Copresence to receive data. 59 // registered by Copresence to receive data.
59 virtual void RegisterTokensCallback( 60 virtual void RegisterTokensCallback(
60 const TokensCallback& tokens_callback) = 0; 61 const TokensCallback& tokens_callback) = 0;
61 virtual void RegisterSamplesCallback( 62 virtual void RegisterSamplesCallback(
62 const SamplesCallback& samples_callback) = 0; 63 const SamplesCallback& samples_callback) = 0;
63 virtual void RegisterDetectBroadcastCallback( 64 virtual void RegisterDetectBroadcastCallback(
64 const SuccessCallback& db_callback) = 0; 65 const SuccessCallback& db_callback) = 0;
65 66
66 // Don't cache these callbacks, as they may become invalid at any time. 67 // Don't cache these callbacks, as they may become invalid at any time.
67 // Always invoke callbacks directly through these accessors. 68 // Always invoke callbacks directly through these accessors.
68 virtual TokensCallback GetTokensCallback() = 0; 69 virtual TokensCallback GetTokensCallback() = 0;
69 virtual SamplesCallback GetSamplesCallback() = 0; 70 virtual SamplesCallback GetSamplesCallback() = 0;
70 virtual SuccessCallback GetDetectBroadcastCallback() = 0; 71 virtual SuccessCallback GetDetectBroadcastCallback() = 0;
71 virtual SuccessCallback GetInitializedCallback() = 0; 72 virtual SuccessCallback GetInitializedCallback() = 0;
72 73
73 virtual ~WhispernetClient() {} 74 virtual ~WhispernetClient() {}
74 }; 75 };
75 76
76 } // namespace copresence 77 } // namespace copresence
77 78
78 #endif // COMPONENTS_COPRESENCE_PUBLIC_WHISPERNET_CLIENT_H_ 79 #endif // COMPONENTS_COPRESENCE_PUBLIC_WHISPERNET_CLIENT_H_
OLDNEW

Powered by Google App Engine
This is Rietveld 408576698