webrtc/api/task_queue/task_queue_factory.h
Markus Handell 4a51622705 TaskQueueFactory: Add kAudio and kVideo priorities
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}
2026-01-26 06:18:27 -08:00

54 lines
1.6 KiB
C++

/*
* Copyright 2019 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 API_TASK_QUEUE_TASK_QUEUE_FACTORY_H_
#define API_TASK_QUEUE_TASK_QUEUE_FACTORY_H_
#include <memory>
#include "absl/strings/string_view.h"
#include "api/task_queue/task_queue_base.h"
namespace webrtc {
// The implementation of this interface must be thread-safe.
class TaskQueueFactory {
public:
// TaskQueue priority levels. On some platforms these will map to thread
// priorities, on others such as Mac and iOS, GCD queue priorities.
enum class Priority {
// Default priority.
kNormal = 0,
// High priority. Use for latency-sensitive tasks.
kHigh,
// Video priority. Use for video pipeline tasks.
kVideo,
// Audio priority. Use for audio pipeline tasks not including rendering.
kAudio,
// Low priority. Use for background tasks (e.g. logging, cleanup).
kLow,
// Deprecated: Use kNormal instead.
NORMAL = kNormal,
// Deprecated: Use kHigh instead.
HIGH = kHigh,
// Deprecated: Use kLow instead.
LOW = kLow,
};
virtual ~TaskQueueFactory() = default;
virtual std::unique_ptr<TaskQueueBase, TaskQueueDeleter> CreateTaskQueue(
absl::string_view name,
Priority priority) const = 0;
};
} // namespace webrtc
#endif // API_TASK_QUEUE_TASK_QUEUE_FACTORY_H_