Kullanıcı etkinlikleri için en iyi uygulamalar

Kullanıcı etkinlikleri, kullanıcıların uygulamanızda başlattıkları görevleri sürdürmelerine yardımcı olur. Yararlı, net ve iyi yapılandırılmış etkinlikler oluşturmak için bu yönergeleri izleyin.

Genel yönergeler

Anlamlı görevler için etkinlik oluşturma

Kullanıcının daha sonra geri dönmek isteyeceği görevler için etkinlikler oluşturun. İyi adaylar şunlardır:

  • Belgeler — Kullanıcının düzenlediği belirli bir belge, elektronik tablo veya dosya.
  • Projeler — Proje çalışma alanı, tasarım veya kod tabanı.
  • Medya — Kullanıcının çaldığı bir şarkı, video veya pod yayını.
  • Oyun ilerleme durumu — Oyun oturumu, düzeyi veya kontrol noktası.

Ayarları görüntüleme, listede gezinme veya sayfalar arasında gezinme gibi önemsiz eylemler için etkinlik oluşturmayın.

Açıklayıcı görüntüleme metni kullanma

  • Kısa ve tanınabilir bir ad (örneğin, "Üç Aylık Rapor" veya "Bölüm 5: Yolculuk") olarak ayarlayın DisplayText .
  • Bağlamı veya ilerlemeyi belirtmek için Description ayarlayın (örneğin, "Bölüm 3'ü Düzenleme — Gelir Analizi").
  • "Adsız" veya "Bir şey üzerinde çalışma" gibi genel metinlerden kaçının.

Kullanıcı ilerledikçe etkinlikleri güncelleştirme

Açıklamayı kullanıcının geçerli konumuyla güncelleştirmek için düzenli aralıklarla arayın SaveAsync() :

UserActivity activity = new UserActivity("quarterly-report");
int currentPage = 3;
int totalPages = 10;

activity.VisualElements.Description = $"Page {currentPage} of {totalPages}";
await activity.SaveAsync();

Uygulama türüne göre etkinlik desenleri

Belge tabanlı uygulamalar

  • Etkinlik kimliği olarak belge dosyası yolunu veya benzersiz tanımlayıcıyı kullanın.
  • Belirli bir belgeyi açmak için ayarlayın ActivationUri .
  • Description öğesini geçerli bölümle güncelleştirin veya konumu düzenleyin.

Oyunlar

  • Etkinlik kimliği olarak kaydetme yuvasını veya oturum tanımlayıcısını kullanın.
  • DisplayText öğesini geçerli düzey veya görev adı olarak ayarlayın.
  • Açıklamaya ilerlemeyi ekleyin (örneğin, "Düzey 12 — 85% tamamlandı").

Medya uygulamaları

  • Etkinlik kimliği olarak medya öğesi tanımlayıcısını kullanın.
  • DisplayText öğesini parça veya bölüm adına ayarlayın.
  • Açıklamaya oynatma konumunu ekleyin (örneğin, "34:15 / 1:02:00").

İş kolu uygulamaları

  • Etkinlik kimliği olarak iş nesnesi tanımlayıcısını (sipariş numarası, müşteri kimliği, servis talebi numarası) kullanın.
  • DisplayText öğesini nesne adı veya numarası olarak ayarlayın.
  • Kullanıcı bir iş akışında ilerledikçe sık sık güncelleştirin.

Zengin görsel yönergeler

Etkinliğin görsel ayrıntılarını ayarlarken:

  • Bunu DisplayText kısa tutun — görevi tanımlayan tek bir satır.
  • Description simgesini paragraf için değil, tek satırlık bir bağlam ya da ilerleme durumu için kullanın.
  • Etkinliğin etkinlik geçmişinde tanınabilmesi için bir Attribution simge ayarlayın.
  • Diğer görsel özellikleri de ayarlasanız bile, etkinliğin okunabilir bir geri dönüşe sahip olması için her zaman değerini ayarlayın DisplayText.
UserActivity activity = new UserActivity("quarterly-report");

activity.VisualElements.DisplayText = "Quarterly Report"; // Fallback
activity.VisualElements.Description = "Page 3 of 10";

Note

Bu kılavuzun önceki sürümlerinde, etkinliğin görseli olarak tam bir Uyarlamalı Kartın (AdaptiveCardBuilder, Windows.UI.Shell ad alanında) eklenmesi öneriliyordu. Bu API, Microsoft kullanımdan kaldırılan Windows Zaman Çizelgesi'nin bir parçasıydı. Yeni kodda kullanmayın AdaptiveCardBuilder ; bunun yerine yukarıda gösterilen özellikleri kullanın VisualElements .

Etkinleştirme URI’si yönergeleri

  • Uygulamanıza kayıtlı özel bir protokol şeması kullanın (örneğin, myapp://).
  • Doğrudan göreve gitmek için URI'ye yeterli bilgi ekleyin.
  • URI'leri kararlı tutun; süresi dolan oturuma özgü belirteçleri eklemeyin.

Örnek:

myapp://document/quarterly-report-2026?page=12

Oturum yönetimi

  • Kullanıcı bir görev üzerinde çalışmaya başladığında bir UserActivitySession oluşturun.
  • Kullanıcı farklı bir göreve geçtiğinde oturumu sonlandır.
  • Etkinlik kanalı başına bir kerede yalnızca bir etkin oturum sürdürebilirsiniz.

İlgili içerik

  • Last updated on