class Reporter
Defined at line 57 of file ../../src/media/audio/audio_core/reporter.h
A singleton instance of |Reporter| handles instrumentation concerns (e.g.
exposing information via inspect, cobalt, etc) for an audio_core instance.
The idea is to make instrumentation as simple as possible for the code that
does the real work. The singleton can be accessed via
Reporter::Singleton()
Given a Reporter, reporting objects can be created through the Create*()
methods. Each reporting object is intended to mirror a single object within
audio_core, such as an AudioRenderer -- the reporting object should live
exactly as long as its parent audio_core object. In addition to Create*()
methods, there are FailedTo*() methods that report when an object could not
be created.
The singleton object always exists: it does not need to be created. However,
the singleton needs to be initialized, via Reporter::InitializeSingleton().
Before that static method is called, all reporting objects created by the
singleton will be no-ops.
The lifetime of each reporting object is divided into sessions. Roughly
speaking, a session corresponds to a contiguous time spent processing audio.
For example, for an AudioRenderer, this is the time between Play and Pause events.
Session lifetimes are controlled by StartSession and StopSession methods.
All times are relative to the system monotonic clock.
This class is fully thread safe, including all static methods and all methods
on reporting objects.
Public Members
static const size_t kObjectsToCachestatic const size_t kVolumeControlsToCachestatic const size_t kActiveUsagePoliciesToCachePublic Methods
void Reporter ()Defined at line 231 of file ../../src/media/audio/audio_core/reporter.h
const inspect::Inspector & inspector ()Exported for tests.
Defined at line 270 of file ../../src/media/audio/audio_core/reporter.h
Reporter & Singleton ()static
Defined at line 1198 of file ../../src/media/audio/audio_core/reporter.cc
void InitializeSingleton (sys::ComponentContext & component_context, async_dispatcher_t * fidl_dispatcher, async_dispatcher_t * io_dispatcher, bool enable_cobalt)static
Defined at line 1209 of file ../../src/media/audio/audio_core/reporter.cc
void Reporter (sys::ComponentContext & component_context, async_dispatcher_t * fidl_dispatcher, async_dispatcher_t * io_dispatcher, bool enable_cobalt)Defined at line 1220 of file ../../src/media/audio/audio_core/reporter.cc
Container<OutputDevice, kObjectsToCache>::Ptr CreateOutputDevice (const std::string & name, const std::string & thread_name)Defined at line 1271 of file ../../src/media/audio/audio_core/reporter.cc
Container<InputDevice, kObjectsToCache>::Ptr CreateInputDevice (const std::string & name, const std::string & thread_name)Defined at line 1279 of file ../../src/media/audio/audio_core/reporter.cc
Container<Renderer, kObjectsToCache>::Ptr CreateRenderer ()Defined at line 1287 of file ../../src/media/audio/audio_core/reporter.cc
Container<Capturer, kObjectsToCache>::Ptr CreateCapturer (const std::string & thread_name)Defined at line 1293 of file ../../src/media/audio/audio_core/reporter.cc
Container<VolumeControl, kVolumeControlsToCache>::Ptr CreateVolumeControl ()Defined at line 1300 of file ../../src/media/audio/audio_core/reporter.cc
void SetNumThermalStates (size_t num)Thermal state of Audio system.
Defined at line 1356 of file ../../src/media/audio/audio_core/reporter.cc
void SetThermalState (uint32_t state)Defined at line 1364 of file ../../src/media/audio/audio_core/reporter.cc
void SetAudioPolicyBehaviorGain (AudioAdmin::BehaviorGain behavior_gain)Audio policy logging of usage activity and behavior (none|duck|mute).
Defined at line 1372 of file ../../src/media/audio/audio_core/reporter.cc
void UpdateActiveUsagePolicy (const std::vector<fuchsia::media::Usage2> & active_usages, const AudioAdmin::RendererPolicies & renderer_policies, const AudioAdmin::CapturerPolicies & capturer_policies)Defined at line 1380 of file ../../src/media/audio/audio_core/reporter.cc
void FailedToConnectToDevice (const std::string & name, bool is_input, zx_status_t status)Device creation failures.
Defined at line 1307 of file ../../src/media/audio/audio_core/reporter.cc
void FailedToObtainStreamChannel (const std::string & name, bool is_input, zx_status_t status)Defined at line 1315 of file ../../src/media/audio/audio_core/reporter.cc
void FailedToStartDevice (const std::string & name)Defined at line 1324 of file ../../src/media/audio/audio_core/reporter.cc
void MixerClockSkewDiscontinuity (zx::duration abs_clock_error)Mixer events which are not easily tied to a specific device or client.
Defined at line 1348 of file ../../src/media/audio/audio_core/reporter.cc
void FailedToApplySchedulerProfile (const std::string & profile, zx_status_t status)Failures when calling RoleManager (to set thread priority or pin processwide memory).
Defined at line 1332 of file ../../src/media/audio/audio_core/reporter.cc
void FailedToApplyMemoryProfile (const std::string & profile, zx_status_t status)Defined at line 1340 of file ../../src/media/audio/audio_core/reporter.cc
Records
Friends
class CapturerImplclass RendererImplclass InputDeviceImplclass OutputDeviceImplclass ObjectTrackerclass OverflowUnderflowTracker