Bagikan melalui

Praktik terbaik Aktivitas Pengguna

  • Artikel

Panduan ini menguraikan praktik yang direkomendasikan untuk membuat dan memperbarui Aktivitas Pengguna. Untuk gambaran umum fitur Aktivitas Pengguna di Windows, lihat Melanjutkan aktivitas pengguna, bahkan di seluruh perangkat. Atau, lihat bagian Aktivitas Pengguna di Project Rome untuk implementasi Aktivitas di platform pengembangan lainnya.

Catatan

Mulai Juli 2021, pengguna yang memiliki riwayat aktivitas yang disinkronkan di seluruh perangkat Windows mereka melalui Akun Microsoft (MSA) mereka tidak akan lagi memiliki opsi untuk mengunggah aktivitas baru di Timeline. Mereka masih dapat menggunakan Garis Waktu dan melihat riwayat aktivitas mereka (informasi tentang aplikasi, situs web, dan file terbaru) di PC lokal mereka. Akun yang terhubung dengan AAD tidak akan terpengaruh.

Kapan harus membuat atau memperbarui Aktivitas Pengguna

Karena setiap aplikasi berbeda, terserah setiap pengembang untuk menentukan cara terbaik untuk memetakan tindakan dalam aplikasi ke Aktivitas Pengguna. Aktivitas Pengguna Anda akan ditampilkan di Cortana dan Timeline, yang berfokus pada peningkatan produktivitas dan efisiensi pengguna dengan membantu mereka kembali ke konten yang mereka kunjungi di masa lalu.

Pedoman umum

  • Rekam satu aktivitas untuk sekelompok tindakan pengguna terkait. Ini sangat relevan untuk daftar putar musik atau Acara TV: satu Aktivitas dapat diperbarui secara berkala untuk mencerminkan kemajuan pengguna. Dalam hal ini, Anda akan memiliki satu Aktivitas Pengguna dengan beberapa Item Riwayat yang mewakili periode keterlibatan selama beberapa hari atau minggu. Hal yang sama berlaku untuk aktivitas berbasis dokumen tempat pengguna membuat kemajuan bertahap dalam aplikasi Anda.
  • Simpan data pengguna di cloud. Jika Anda ingin mendukung Aktivitas lintas perangkat, Anda harus memastikan konten yang diperlukan untuk melibatkan kembali Aktivitas ini disimpan ke lokasi cloud. Aktivitas khusus perangkat akan muncul di Garis Waktu pada perangkat tempat aktivitas dibuat tetapi mungkin tidak muncul di perangkat lain.
  • Jangan membuat Aktivitas untuk tindakan yang tidak perlu dilanjutkan oleh pengguna. Jika aplikasi Anda digunakan untuk menyelesaikan operasi satu kali sederhana yang tidak mempertahankan status, Anda mungkin tidak perlu membuat Aktivitas Pengguna.
  • Jangan membuat Aktivitas untuk tindakan yang diselesaikan oleh pengguna lain. Jika akun eksternal mengirimi pengguna pesan atau @-mentions mereka dalam aplikasi, Anda tidak boleh membuat Aktivitas untuk ini. Jenis tindakan ini lebih baik dilayani oleh Pemberitahuan Pusat Tindakan.
    • Skenario kolaborasi adalah pengecualian: Jika beberapa pengguna mengerjakan aktivitas yang sama bersama-sama (seperti dokumen Word), akan ada kasus di mana pengguna lain telah membuat perubahan setelah pengguna Anda. Dalam hal ini, Anda mungkin ingin memperbarui Aktivitas yang ada untuk mencerminkan perubahan yang dibuat pada dokumen. Ini akan melibatkan pembaruan data konten Aktivitas Pengguna yang ada tanpa membuat Item Riwayat baru.

Panduan untuk jenis aplikasi tertentu

Meskipun setiap aplikasi berbeda, sebagian besar aplikasi akan termasuk dalam salah satu pola interaksi berikut.

  • Aplikasi berbasis dokumen — Buat satu Aktivitas per dokumen, dengan satu atau beberapa Item Riwayat mencerminkan periode penggunaan. Penting untuk memperbarui Aktivitas Anda saat perubahan dilakukan pada dokumen.
  • Game — Buat satu Aktivitas untuk setiap penyimpanan game atau dunia. Jika game Anda hanya mendukung satu urutan level, Anda dapat menerbitkan ulang Aktivitas yang sama dari waktu ke waktu, meskipun Anda mungkin ingin memperbarui data konten untuk menunjukkan kemajuan atau pencapaian terbaru.
  • Aplikasi utilitas — Jika tidak ada apa pun dalam aplikasi Anda yang perlu dilewati dan dilanjutkan pengguna, Anda tidak perlu menggunakan Aktivitas Pengguna. Contoh yang baik adalah aplikasi sederhana seperti Kalkulator.
  • Aplikasi lini bisnis — Banyak aplikasi ada untuk mengelola tugas atau alur kerja sederhana. Buat satu aktivitas untuk setiap alur kerja terpisah yang diakses melalui aplikasi Anda (misalnya, laporan pengeluaran masing-masing akan menjadi Aktivitas terpisah, sehingga pengguna kemudian dapat mengklik Aktivitas untuk melihat apakah laporan tertentu disetujui).
  • Aplikasi pemutaran media — Buat satu Aktivitas per pengelompokan konten logis (seperti daftar putar, program, atau konten mandiri). Pertanyaan yang mendasar untuk pengembang aplikasi adalah apakah setiap bagian konten (episode TV, lagu) dihitung sebagai konten mandiri atau bagian dari koleksi. Sebagai aturan umum, jika pengguna memilih untuk memutar koleksi atau konten berurutan, koleksi secara keseluruhan adalah aktivitas. Jika mereka memilih untuk memutar satu konten, maka satu konten tersebut adalah aktivitas. Lihat panduan lebih spesifik di bawah ini.
    • Musik: Album/Artis/Genre — Jika pengguna memilih Album, Artis, atau Genre dan pemutaran hit, koleksi tersebut adalah aktivitas; jangan tulis Aktivitas terpisah untuk setiap lagu. Untuk koleksi pendek seperti satu album atau koleksi yang diputar kembali dalam urutan acak, Anda mungkin tidak perlu memperbarui Aktivitas untuk mencerminkan posisi pengguna saat ini. Untuk pemutaran berurutan yang panjang seperti album atau daftar putar, merekam posisi Anda dalam album mungkin masuk akal.
    • Musik: daftar putar pintar — Aplikasi yang memutar musik dalam urutan acak harus merekam satu Aktivitas untuk daftar putar tersebut. Jika pengguna memutar daftar putar untuk kedua kalinya, Anda akan membuat rekaman riwayat tambahan untuk Aktivitas yang sama. Merekam posisi pengguna saat ini dalam daftar putar tidak diperlukan karena urutannya acak.
    • Serial TV — Jika aplikasi Anda dikonfigurasi untuk memutar episode berikutnya setelah episode saat ini selesai, Anda harus menulis satu Aktivitas untuk serial TV. Saat memutar berbagai episode di beberapa sesi penayangan, Anda akan memperbarui Aktivitas untuk mencerminkan posisi saat ini dalam seri, dan beberapa rekaman riwayat akan dibuat.
    • Film — Film adalah konten tunggal dan harus memiliki catatan riwayatnya sendiri. Jika pengguna berhenti menonton film secara part-way, diinginkan untuk merekam posisi mereka. Ketika mereka ingin melanjutkannya di masa mendatang, Aktivitas dapat melanjutkan film di mana mereka meninggalkan, atau bahkan bertanya kepada pengguna apakah mereka ingin melanjutkan atau memulai di awal.

Desain Aktivitas Pengguna

Aktivitas Pengguna terdiri dari tiga komponen: URI aktivasi, data visual, dan metadata konten.

  • URI aktivasi adalah URI yang dapat diteruskan ke aplikasi atau pengalaman untuk melanjutkan aplikasi dengan konteks tertentu. Biasanya, tautan ini mengambil bentuk handler protokol untuk skema (misalnya, "my-app://page2?action=edit"). Terserah pengembang untuk menentukan bagaimana parameter URI akan ditangani oleh aplikasi mereka. Lihat Menangani aktivasi URI untuk informasi selengkapnya.
  • Data visual, yang terdiri dari sekumpulan properti yang diperlukan dan opsional (misalnya: elemen judul, deskripsi, atau Kartu Adaptif), memungkinkan pengguna mengidentifikasi Aktivitas secara visual. Lihat di bawah ini untuk panduan tentang membuat visual Kartu Adaptif untuk Aktivitas Anda.
  • Metadata konten adalah data JSON yang dapat digunakan untuk mengelompokkan dan mengambil aktivitas di bawah konteks tertentu. Biasanya, ini mengambil bentuk http://schema.org data. Lihat di bawah ini untuk panduan mengisi data ini.

Panduan desain Kartu Adaptif

Saat Aktivitas muncul di Garis Waktu, aktivitas ditampilkan menggunakan kerangka kerja Kartu Adaptif. Jika pengembang tidak menyediakan Kartu Adaptif untuk setiap Aktivitas, Garis Waktu akan secara otomatis membuat kartu sederhana berdasarkan nama/ikon aplikasi, bidang Judul yang diperlukan, dan bidang Deskripsi opsional.

Pengembang aplikasi didorong untuk menyediakan kartu kustom menggunakan skema JSON Kartu Adaptif sederhana. Lihat dokumentasi Kartu Adaptif untuk petunjuk teknis tentang cara membuat objek Kartu Adaptif. Lihat panduan di bawah ini untuk merancang Kartu Adaptif dalam Aktivitas Pengguna.

  • Menggunakan gambar
    • Gunakan gambar unik untuk setiap Aktivitas, jika memungkinkan. Nama dan ikon aplikasi Anda akan ditampilkan secara otomatis di samping kartu Aktivitas Anda; gambar tambahan akan membantu pengguna menemukan Aktivitas yang mereka cari.
    • Gambar tidak boleh menyertakan teks yang diharapkan dibaca pengguna. Teks ini tidak akan tersedia untuk pengguna dengan kebutuhan aksesibilitas dan tidak dapat dicari.
    • Jika gambar tidak berisi teks dan dapat dipangkas menjadi rasio 2:1, Anda harus menggunakannya sebagai gambar latar belakang. Ini menghasilkan kartu aktivitas tebal yang akan menonjol di Garis Waktu. Gambar akan sedikit digelapkan untuk memastikan teks tetap terlihat pada kartu, dan Anda dianjurkan untuk hanya menggunakan Nama Aktivitas dalam hal ini, karena teks yang lebih kecil dapat menjadi sulit dibaca.
    • Jika gambar tidak dapat dipangkas menjadi 2:1, Anda harus memasukkannya ke dalam Kartu Aktivitas.
      • Jika rasio aspek adalah Persegi atau Potret, jangkar gambar di sisi kanan kartu tanpa margin.
      • Jika rasio aspek adalah Lanskap, jangkar gambar ke sudut kanan atas kartu.
  • Setiap aktivitas diperlukan untuk memberikan Nama Aktivitas, yang harus selalu ditampilkan.
    • Nama ini harus ditampilkan di sudut kiri atas kartu menggunakan opsi teks tebal besar. Penting bahwa namanya mudah dikenali, karena ini adalah satu-satunya bagian yang akan dilihat pengguna ketika aktivitas ditampilkan dalam skenario Cortana. Menampilkan nama yang sama di Garis Waktu memudahkan pengguna untuk menelusuri sejumlah besar Aktivitas.
  • Gunakan gaya visual yang sama untuk semua Aktivitas dari aplikasi Anda, sehingga pengguna dapat dengan mudah menemukan aktivitas aplikasi Anda di Garis Waktu.
    • Misalnya, Semua aktivitas harus menggunakan warna latar belakang yang sama.
  • Gunakan informasi teks tambahan dengan hemat.
    • Hindari mengisi kartu dengan teks, dan hanya gunakan informasi tambahan yang membantu pengguna dalam menemukan aktivitas yang tepat atau mencerminkan informasi status (seperti kemajuan saat ini dalam tugas tertentu).

Panduan metadata konten

Aktivitas Pengguna juga dapat berisi metadata konten, yang digunakan Windows dan Cortana untuk mengategorikan Aktivitas dan menghasilkan inferensi. Aktivitas kemudian dapat dikelompokkan di sekitar topik tertentu, seperti lokasi (jika pengguna meneliti liburan), objek (jika pengguna meneliti sesuatu) atau tindakan (jika pengguna berbelanja produk tertentu di berbagai aplikasi dan situs web). Ada baiknya untuk mewakili kata benda dan kata kerja yang terlibat dalam suatu aktivitas.

Dalam contoh berikut, metadata konten JSON, mengikuti standar Schema.org, mewakili skenario: "John memainkan Angry Birds dengan Steve."

// John played angry birds with Steve.
{
  "@context": "http://schema.org",
  "@type": "PlayAction",
  "agent": {
    "@type": "Person",
    "name": "John"
  },
  "object": {
    "@type": "MobileApplication",
    "name": "Angry Birds."
  },
  "participant": {
    "@type": "Person",
    "name": "Steve"
  }
}

API Kunci