従来の UDP

既存の連携向けに UDP を引き続き利用できます。新しい連携には WebSocket を推奨します。

127.0.0.1:42069 にデータグラムごとに 1 個の UTF-8 JSON オブジェクトを送ります。WebSocket のエンベロープは付けません。

import json
import socket

message = {
    "messageType": 1,
    "title": "Hello from UDP",
    "content": "An existing integration can still send notifications.",
    "sourceApp": "YourApp",
    "timeout": 5.0,
}
with socket.socket(socket.AF_INET, socket.SOCK_DGRAM) as connection:
    connection.sendto(
        json.dumps(message).encode("utf-8"),
        ("127.0.0.1", 42069),
    )

UDP の送信は Astral Overlay による受信や表示を確認しません。何も表示されない場合は Notification API 設定と、他のアプリによるポート占有を確認してください。

共通のペイロードのリファレンスも参照してください。