IDesktopNotifications interface

Namespace Runic.Platform · Runic.Platform 0.7.0-preview.5

public interface IDesktopNotifications : IAsyncDisposable

Inherits or implements IAsyncDisposable.

Application-scoped native notifications with explicit authorization.

Methods

RemoveAsync

ValueTask<PlatformResult<PlatformUnit>> RemoveAsync(string id, CancellationToken cancellationToken = default)

Removes a notification with an application-owned identifier.

RequestPermissionAsync

ValueTask<PlatformResult<PlatformUnit>> RequestPermissionAsync(CancellationToken cancellationToken = default)

Requests or checks OS authorization; Windows and Linux do not show a separate consent prompt.

Remarks

Windows may not have settings for a newly registered app. Success permits an attempt; submission still enforces native registration and policy and never guarantees visibility.

ShowAsync

ValueTask<PlatformResult<PlatformUnit>> ShowAsync(DesktopNotification notification, CancellationToken cancellationToken = default)

Submits or replaces a notification; success acknowledges submission, not visibility.

Events

Activated

event EventHandler<DesktopNotificationActivation>? Activated

Raised on a worker thread; dispatch window work through its presentation.