4a51622705
This change introduces specific priority levels for audio and video tasks within the TaskQueueFactory to allow for better platform-specific thread scheduling. Changes: * New field trial WebRTC-MediaTaskQueuePriorities that activates the priority change. * New Priority Enums: Added kVideo and kAudio to TaskQueueFactory::Priority and corresponding kVideo and kAudio to ThreadPriority. * WebRTC platform thread implementation: - Video priority initially maps to high priority. - On Mac/iOS (GCD), both audio and video map to DISPATCH_QUEUE_PRIORITY_HIGH because of API limitation. * Task queue updates: - Updated the audio encoder queue to use kAudio priority. - Updated the video encoder & decoder, incoming video stream, and video frame transformer queues to use kVideo priority. * Queue renaming: Standardized several task queue names by appending "Queue" (e.g., "AudioEncoder" became "AudioEncoderQueue"). Bug: chromium:470337728 Change-Id: I4790990340a72a54945750c2c4e1f97314edf375 Reviewed-on: https://webrtc-review.googlesource.com/c/src/+/436580 Reviewed-by: Tomas Gunnarsson <tommi@webrtc.org> Commit-Queue: Markus Handell <handellm@webrtc.org> Cr-Commit-Position: refs/heads/main@{#46744}
125 lines
3.9 KiB
C++
125 lines
3.9 KiB
C++
/*
|
|
* Copyright (c) 2015 The WebRTC project authors. All Rights Reserved.
|
|
*
|
|
* Use of this source code is governed by a BSD-style license
|
|
* that can be found in the LICENSE file in the root of the source
|
|
* tree. An additional intellectual property rights grant can be found
|
|
* in the file PATENTS. All contributing project authors may
|
|
* be found in the AUTHORS file in the root of the source tree.
|
|
*/
|
|
|
|
#ifndef RTC_BASE_PLATFORM_THREAD_H_
|
|
#define RTC_BASE_PLATFORM_THREAD_H_
|
|
|
|
#include <optional>
|
|
|
|
#include "absl/functional/any_invocable.h"
|
|
#include "absl/strings/string_view.h"
|
|
#include "rtc_base/platform_thread_types.h" // IWYU pragma: keep
|
|
|
|
#if !defined(WEBRTC_WIN)
|
|
#include <pthread.h> // IWYU pragma: keep
|
|
#endif
|
|
|
|
namespace webrtc {
|
|
|
|
enum class ThreadPriority {
|
|
kLow = 1,
|
|
kNormal,
|
|
kHigh,
|
|
kVideo,
|
|
kAudio,
|
|
kRealtime,
|
|
};
|
|
|
|
struct ThreadAttributes {
|
|
ThreadPriority priority = ThreadPriority::kNormal;
|
|
ThreadAttributes& SetPriority(ThreadPriority priority_param) {
|
|
priority = priority_param;
|
|
return *this;
|
|
}
|
|
};
|
|
|
|
// Represents a simple worker thread.
|
|
class PlatformThread final {
|
|
public:
|
|
// Handle is the base platform thread handle.
|
|
#if defined(WEBRTC_WIN)
|
|
using Handle = HANDLE;
|
|
#else
|
|
using Handle = pthread_t;
|
|
#endif // defined(WEBRTC_WIN)
|
|
// This ctor creates the PlatformThread with an unset handle (returning true
|
|
// in empty()) and is provided for convenience.
|
|
// TODO(bugs.webrtc.org/12727) Look into if default and move support can be
|
|
// removed.
|
|
PlatformThread() = default;
|
|
|
|
// Moves `rhs` into this, storing an empty state in `rhs`.
|
|
// TODO(bugs.webrtc.org/12727) Look into if default and move support can be
|
|
// removed.
|
|
PlatformThread(PlatformThread&& rhs);
|
|
|
|
// Copies won't work since we'd have problems with joinable threads.
|
|
PlatformThread(const PlatformThread&) = delete;
|
|
PlatformThread& operator=(const PlatformThread&) = delete;
|
|
|
|
// Moves `rhs` into this, storing an empty state in `rhs`.
|
|
// TODO(bugs.webrtc.org/12727) Look into if default and move support can be
|
|
// removed.
|
|
PlatformThread& operator=(PlatformThread&& rhs);
|
|
|
|
// For a PlatformThread that's been spawned joinable, the destructor suspends
|
|
// the calling thread until the created thread exits unless the thread has
|
|
// already exited.
|
|
~PlatformThread();
|
|
|
|
// Finalizes any allocated resources.
|
|
// For a PlatformThread that's been spawned joinable, Finalize() suspends
|
|
// the calling thread until the created thread exits unless the thread has
|
|
// already exited.
|
|
// empty() returns true after completion.
|
|
void Finalize();
|
|
|
|
// Returns true if default constructed, moved from, or Finalize()ed.
|
|
bool empty() const { return !handle_.has_value(); }
|
|
|
|
// Creates a started joinable thread which will be joined when the returned
|
|
// PlatformThread destructs or Finalize() is called.
|
|
static PlatformThread SpawnJoinable(
|
|
absl::AnyInvocable<void() &&> thread_function,
|
|
absl::string_view name,
|
|
ThreadAttributes attributes = ThreadAttributes());
|
|
|
|
// Creates a started detached thread. The caller has to use external
|
|
// synchronization as nothing is provided by the PlatformThread construct.
|
|
static PlatformThread SpawnDetached(
|
|
absl::AnyInvocable<void() &&> thread_function,
|
|
absl::string_view name,
|
|
ThreadAttributes attributes = ThreadAttributes());
|
|
|
|
// Returns the base platform thread handle of this thread.
|
|
std::optional<Handle> GetHandle() const;
|
|
|
|
#if defined(WEBRTC_WIN)
|
|
// Queue a Windows APC function that runs when the thread is alertable.
|
|
bool QueueAPC(PAPCFUNC apc_function, ULONG_PTR data);
|
|
#endif
|
|
|
|
private:
|
|
PlatformThread(Handle handle, bool joinable);
|
|
static PlatformThread SpawnThread(
|
|
absl::AnyInvocable<void() &&> thread_function,
|
|
absl::string_view name,
|
|
ThreadAttributes attributes,
|
|
bool joinable);
|
|
|
|
std::optional<Handle> handle_;
|
|
bool joinable_ = false;
|
|
};
|
|
|
|
} // namespace webrtc
|
|
|
|
|
|
#endif // RTC_BASE_PLATFORM_THREAD_H_
|