1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
media / base / audio_latency.h [blame]
// Copyright 2016 The Chromium Authors
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
#ifndef MEDIA_BASE_AUDIO_LATENCY_H_
#define MEDIA_BASE_AUDIO_LATENCY_H_
#include "media/base/media_shmem_export.h"
namespace base {
class TimeDelta;
}
namespace media {
class MEDIA_SHMEM_EXPORT AudioLatency {
public:
// Categories of expected latencies for input/output audio. Do not change
// existing values, they are used for UMA histogram reporting.
enum class Type {
// Specific latency in milliseconds.
kExactMS = 0,
// Lowest possible latency which does not cause glitches.
kInteractive = 1,
// Latency optimized for real time communication.
kRtc = 2,
// Latency optimized for continuous playback and power saving.
kPlayback = 3,
// Default value when the type is unknown.
kUnknown = 4,
kMaxValue = kUnknown,
};
// Indicates if the OS does not require resampling for playback.
static bool IsResamplingPassthroughSupported(Type type);
// |preferred_buffer_size| should be set to 0 if a client has no preference.
static int GetHighLatencyBufferSize(int sample_rate,
int preferred_buffer_size);
// |hardware_buffer_size| should be set to 0 if unknown/invalid/not preferred.
static int GetRtcBufferSize(int sample_rate, int hardware_buffer_size);
static int GetInteractiveBufferSize(int hardware_buffer_size);
// Return the closest buffer size for this platform that will result in a
// latency not less than `duration` for the given `sample_rate`.
//
// Requirements:
// - `hardware_buffer_size > 0` and `max_allowed_buffer_size > 0`.
// - If `min_hardware_buffer_size` and `max_hardware_buffer_size` are > 0 then
// the following must be true: `min_hardware_buffer_size <=
// hardware_buffer_size <= max_hardware_buffer_size`
// - `hardware_buffer_size <= max_allowed_buffer_size`
//
// The returned buffer size is guaranteed to be between
// `min_hardware_buffer_size` and `max_allowed_buffer_size`.
// `max_hardware_buffer_size` is used to help determine a buffer size that
// won't cause the caller and the hardware to run at unsynchronized buffer
// sizes (e.g. hardware running at 4096 and caller running at 4224).
// `hardware_buffer_size` is the platform's preferred buffer size.
//
// TODO(crbug.com/40248990) Ensure that all callers validate conditions listed
// above.
//
// It is valid for both the min and max to be zero in which case only
// `hardware_buffer_size` and multiples of it will be used.
static int GetExactBufferSize(base::TimeDelta duration,
int sample_rate,
int hardware_buffer_size,
int min_hardware_buffer_size,
int max_hardware_buffer_size,
int max_allowed_buffer_size);
static const char* ToString(Type type);
};
} // namespace media
#endif // MEDIA_BASE_AUDIO_LATENCY_H_