1
0
mirror of https://github.com/ppy/osu.git synced 2024-12-16 20:13:21 +08:00
osu-lazer/osu.Game/Online/Spectator/ISpectatorServer.cs

45 lines
1.6 KiB
C#
Raw Normal View History

2020-10-22 18:41:10 +08:00
// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
// See the LICENCE file in the repository root for full licence text.
using System.Threading.Tasks;
namespace osu.Game.Online.Spectator
{
2020-10-22 12:12:58 +08:00
/// <summary>
/// An interface defining the spectator server instance.
/// </summary>
public interface ISpectatorServer
{
2020-10-22 12:12:58 +08:00
/// <summary>
/// Signal the start of a new play session.
/// </summary>
2020-10-22 16:29:38 +08:00
/// <param name="state">The state of gameplay.</param>
Task BeginPlaySession(SpectatorState state);
2020-10-22 12:12:58 +08:00
/// <summary>
/// Send a bundle of frame data for the current play session.
/// </summary>
/// <param name="data">The frame data.</param>
Task SendFrameData(FrameDataBundle data);
2020-10-22 12:12:58 +08:00
/// <summary>
/// Signal the end of a play session.
/// </summary>
2020-10-22 16:29:38 +08:00
/// <param name="state">The state of gameplay.</param>
Task EndPlaySession(SpectatorState state);
2020-10-22 12:12:58 +08:00
/// <summary>
/// Request spectating data for the specified user. May be called on multiple users and offline users.
/// For offline users, a subscription will be created and data will begin streaming on next play.
/// </summary>
/// <param name="userId">The user to subscribe to.</param>
Task StartWatchingUser(int userId);
2020-10-22 12:12:58 +08:00
/// <summary>
/// Stop requesting spectating data for the specified user. Unsubscribes from receiving further data.
/// </summary>
/// <param name="userId">The user to unsubscribe from.</param>
Task EndWatchingUser(int userId);
}
}