[jazzy] Add PlayerClock::wakeup() to interrupt sleeping (backport #1869)

[mergify]

This adds a new wakeup() method to PlayerClock. It wakes up the clock, which is (only) useful if it is currently sleeping, i.e., in a sleep_until() call. Just calling std::condition_variable::notify_all() on the clock's condition variable wakes it up from its sleep (i.e., std::condition_variable::wait_for() and std::condition_variable::wait_until()):

The thread will be unblocked when notify_all() or notify_one() is executed, or abs_time is reached. It may also be unblocked spuriously.

This can then replace the current workaround in Player::stop() to force-wakeup the clock, which is to resume the clock and then immediately pause it. Since we don't actually want to pause the clock, doing this may have unintended consequences, e.g., if the player is woken up and then thinks it's not in pause mode anymore.

I want to use this in #1848, but I thought a separate PR would be easier to review.

---

This is an automatic backport of pull request #1869 done by Mergify.

[MichaelOrlov]

I made backporting PR ABI-compatible

• Made "is_sleeping()" and " wakeup()" functions as non-virtual and
  defined only in the derived "TimeControllerClock" class.
• Uses "TimeControllerClock" directly instead of the "PlayerClock" base
  class in the player.cpp.

[MichaelOrlov]

Pulls: #1875
Gist: https://gist.githubusercontent.com/MichaelOrlov/024215e861b5d29c57ff0307548bcbbb/raw/8513d6ff4baab7e22cabb56e455efa3d8d09854e/ros2.repos
BUILD args: --packages-above-and-dependencies rosbag2_cpp rosbag2_transport
TEST args: --packages-above rosbag2_cpp rosbag2_transport
ROS Distro: jazzy
Job: ci_launcher
ci_launcher ran: https://ci.ros2.org/job/ci_launcher/14900

• Linux
• Linux-aarch64
• Linux-rhel
• Windows

[christophebedard]

here's an after-the-fact approval ✔️