PushizoDocs

Windows (WNS)

Microsoft Store ile ilişkilendirilmiş Windows uygulamalarına WNS bildirimi — paket gerekmez, kanal adresi SDK kayıt uç noktasına yazılır.

Microsoft Store ile ilişkilendirilmiş (MSIX paketli) Windows uygulamaları, Windows Push Notification Services (WNS) üzerinden wns_push kanalıyla bildirim alır. Ayrı bir Pushizo paketi yoktur: uygulama Windows SDK'nın kanal API'siyle kanal adresini alır ve SDK kayıt uç noktasına yazar. Sunucu tarafı (gönderim, kimlik doğrulama, adres denetimi) ADR-0052'dedir.

1. Partner Center ve Visual Studio

  1. Partner Center → uygulamanız → Ürün kimliği (Product identity): Package SID (ms-app://s-1-15-2-…).
  2. Partner Center → uygulamanız → WNS/MPNS: Client secret.
  3. Visual Studio → proje → Publish → Associate App with the Store. Package SID bu ilişkilendirmeyle uygulamaya bağlanır.

2. Panel

Kanallar → Windows Bildirim Hizmeti (ya da kurulum sihirbazında Windows (WNS) kartı): Package SID ve Client Secret'ı girin. Kayıt sırasında WNS OAuth uç noktasına karşı doğrulanır; sır sunucuda şifreli saklanır, geri gösterilmez.

3. Uygulama kodu (C#)

Panelde Başlarken → SDK kodu → Windows (WNS) App ID'niz ve API adresiniz yerleştirilmiş hâlini verir.

using System.Net.Http.Json;
using System.Text.Json;
using System.Text.Json.Serialization;
using Windows.Networking.PushNotifications;

public static class PushizoWindows
{
    private static readonly HttpClient Http = new();
    private static readonly JsonSerializerOptions Json = new() { DefaultIgnoreCondition = JsonIgnoreCondition.WhenWritingNull };

    // Her açılışta çağırın: kanal adresi zamanla değişir, aynı adres ikinci abonelik oluşturmaz.
    public static async Task RegisterAsync(string? externalId = null)
    {
        var channel = await PushNotificationChannelManager.CreatePushNotificationChannelForApplicationAsync();
        var timezone = TimeZoneInfo.TryConvertWindowsIdToIanaId(TimeZoneInfo.Local.Id, out var iana) ? iana : null;
        var body = new
        {
            channel = "wns_push",
            token = channel.Uri,
            device = new { os = "Windows", os_version = Environment.OSVersion.Version.ToString(), sdk_platform = "windows", locale = System.Globalization.CultureInfo.CurrentUICulture.Name, timezone },
            user = externalId is null ? null : new { external_id = externalId },
        };
        var response = await Http.PostAsJsonAsync("https://api.pushizo.com/sdk/v1/apps/<APP_ID>/subscriptions", body, Json);
        response.EnsureSuccessStatusCode();
    }
}
  • Kayıt POST /sdk/v1/apps/{appId}/subscriptions (channel: "wns_push", token = kanal adresi) idempotenttir.
  • Gönderimde yalnızca https://*.notify.windows.com adreslerine istek yapılır; başka adresli abonelik geçersiz token olarak işaretlenir ve kapatılır.
  • Bildirim wns/toast (ToastGeneric: başlık + metin) olarak gider; bildirimin adresi varsa toast launch değerine yazılır.
  • Kullanıcıyı kendi kimliğinizle eşlemek için externalId verin (user.external_id).
  • WNS'nin süresi dolmuş/geçersiz kanal yanıtında abonelik sunucuda kapatılır.

Sınırlar

  • Dokunma/açılma ölçümü yoktur (toast'ta teslimat kimliği taşınmaz); teslim ve hata durumları raporlanır.
  • In-app mesaj, bildirim kutusu ve konum özellikleri Windows'ta yoktur. .NET MAUI SDK'sının Windows hedefinde bu çağrılar etkisizdir; MAUI ile Windows'a bildirim için bu sayfadaki kayıt kodu kullanılır.

Bu sayfada