Catatan
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba masuk atau mengubah direktori.
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba mengubah direktori.
Peringatan
Dokumen ini telah diarsipkan dan komponen tidak tersedia dalam versi Windows Community Toolkit saat ini.
Komunitas dipersilakan untuk menyatakan minat atau berkontribusi pada penyertaannya, meskipun kami ingin mencatat bahwa:
- Kami tidak terbuka untuk memindahkan komponen ini ke 8.x.
- Tidak ada pengganti yang direkomendasikan yang diketahui untuk komponen ini.
Untuk informasi selengkapnya:
Dokumentasi asli mengikuti di bawah ini.
Peringatan
Layanan Facebook tidak lagi tersedia di Windows Community Toolkit. Pustaka bergantung utama tidak lagi didukung.
Layanan Facebook memungkinkan Anda mengambil atau menerbitkan data ke grafik Facebook. Contoh jenis objek yang dapat Anda kerjakan adalah Postingan, Objek Bertag, dan umpan pengguna utama.
Mendapatkan Windows Store SID
Windows Store SID adalah nilai unik per aplikasi yang dihasilkan, dan tidak terkait dengan penerbitan toko yang sebenarnya. Membuat aplikasi lokal akan memberi Anda SID valid yang dapat digunakan untuk debugging terhadap Facebook.
// Put the following code in your mainform loaded event
// Note that this will not work in the App.xaml.cs Loaded
#if DEBUG
System.Diagnostics.Debug.WriteLine("Windows Store SID = " + Microsoft.Toolkit.Uwp.Services.Facebook.FacebookService.Instance.WindowsStoreId);
#endif
' Put the following code in your mainform loaded event
' Note that this will not work in the App.xaml.cs Loaded
#If DEBUG Then
System.Diagnostics.Debug.WriteLine("Windows Store SID = " & Microsoft.Toolkit.Uwp.Services.Facebook.FacebookService.Instance.WindowsStoreId)
#End If
Nota
Anda mungkin harus mengaktifkan jendela Output di Visual Studio untuk melihat baris tulis debug ini.
Kode di atas akan menghasilkan sesuatu seperti ini:
Windows Store SID = ms-app://s-1-15-2-12341451-1486691014-2395677208-123421631-1234998043-1234490472-123452499/
Saat memasukkan nilai ke situs Pengembang Facebook, Anda harus menghapus ms-app:// dan tanda garis miring di akhir dari string tersebut.
Membuat Aplikasi baru di Situs Pengembang Facebook
- Untuk mendapatkan Facebook.WindowsStoreID, buka: https://developers.facebook.com/apps.
- Pilih Buat ID Aplikasi Baru, untuk memulai integrasi Facebook ke aplikasi atau situs web Anda.
- Klik, Buat Aplikasi Baru
- Dari Dasbor aplikasi pilih item Pengaturan di sebelah kiri. Ini harus memilih item Dasar di bawahnya secara default.
- +Tambahkan Platform pilih Aplikasi Windows. Biarkan entri Namespace dan Domain Aplikasi kosong.
- Masukkan Windows Store SID dari dalam aplikasi Anda (lihat bagian Mendapatkan Windows Store SID)
- Dari menu di sisi kiri pilih +Tambahkan Produk untuk menambahkan Login Facebook. Pastikan Anda mengatur opsi berikut di UI:
| Setting | Nilai |
|---|---|
| Masuk Klien OAuth | Yes |
| Web OAuth Login | Tidak. |
| Login OAuth Peramban Tertanam | Yes |
| Pengaktifan Paksa Pengalihan OAuth pada Web | Tidak. |
| Masuk dari Perangkat | Tidak. |
| URI pengalihan OAuth yang valid | Blank |
Syntax
// Initialize service
FacebookService.Instance.Initialize(AppIDText.Text);
// Login to Facebook
if (!await FacebookService.Instance.LoginAsync())
{
return;
}
// Get user's feed
ListView.ItemsSource = await FacebookService.Instance.RequestAsync(FacebookDataConfig.MyFeed, 50);
// Get current user profile picture
ProfileImage.DataContext = await FacebookService.Instance.GetUserPictureInfoAsync();
// Post a message on your wall using Facebook Dialog
await FacebookService.Instance.PostToFeedWithDialogAsync(TitleText.Text, DescriptionText.Text, UrlText.Text);
// Get current user's photo albums
await FacebookService.Instance.GetUserAlbumsAsync();
// Get current user's photos by album Id
await FacebookService.Instance.GetUserPhotosByAlbumIdAsync(addedItem.Id);
' Initialize service
FacebookService.Instance.Initialize(AppIDText.Text)
' Login to Facebook
If Not Await FacebookService.Instance.LoginAsync() Then
Return
End If
' Get user's feed
ListView.ItemsSource = Await FacebookService.Instance.RequestAsync(FacebookDataConfig.MyFeed, 50)
' Get current user profile picture
ProfileImage.DataContext = Await FacebookService.Instance.GetUserPictureInfoAsync()
' Post a message on your wall using Facebook Dialog
Await FacebookService.Instance.PostToFeedWithDialogAsync(TitleText.Text, DescriptionText.Text, UrlText.Text)
' Get current user's photo albums
Await FacebookService.Instance.GetUserAlbumsAsync()
' Get current user's photos by album Id
Await FacebookService.Instance.GetUserPhotosByAlbumIdAsync(addedItem.Id)
Kelas FacebookAlbum
FacebookAlbum memiliki properti untuk menyimpan detail album
Karakteristik
| Harta benda | Tipe | Description |
|---|---|---|
| Foto_Sampul | FacebookPhoto | Mendapatkan atau mengatur properti cover_photo |
| Description | string | Mendapatkan atau mengatur properti deskripsi |
| Nomor Identitas | string | Mendapatkan atau mengatur properti id |
| Nama | string | Mendapatkan atau mengatur properti nama |
| Gambar | FacebookPictureData | Mendapatkan atau mengatur atribut gambar |
Kelas FacebookDataConfig
Objek konfigurasi untuk menentukan informasi kueri yang lebih kaya
Fields
| Bidang | Tipe | Description |
|---|---|---|
| MyFeed | FacebookDataConfig | Mendapatkan konfigurasi yang telah ditentukan sebelumnya untuk mendapatkan umpan pengguna. Umpan postingan (termasuk pembaruan status) dan tautan yang diterbitkan oleh orang ini, atau oleh orang lain di profil orang ini |
| Postinganku | FacebookDataConfig | Mendapatkan konfigurasi yang telah ditentukan sebelumnya untuk hanya menampilkan postingan yang diterbitkan oleh orang ini |
| MyTagged | FacebookDataConfig | Mendapatkan konfigurasi yang sudah ditentukan sebelumnya untuk hanya menampilkan postingan di mana orang ini ditandai |
Karakteristik
| Harta benda | Tipe | Description |
|---|---|---|
| Pertanyaan | string | Mendapatkan atau mengatur string kueri untuk memfilter hasil layanan |
Kelas FacebookOAuthTokens
Token OAuth Facebook
Karakteristik
| Harta benda | Tipe | Description |
|---|---|---|
| AppId | string | Mendapatkan atau mengatur AppId facebook |
| WindowsStoreId | string | Mendapatkan atau menyetel ID Windows Store |
Kelas FacebookPhoto
FacebookAlbum memiliki properti untuk menyimpan detail foto
Karakteristik
| Harta benda | Tipe | Description |
|---|---|---|
| Album | int | Mendapatkan atau mengatur properti album |
| Waktu_Dibuat | int | Mendapatkan atau mengatur waktu instans entitas dibuat |
| Nomor Identitas | string | Mendapatkan atau mengatur properti id |
| Gambar | int | Mendapatkan atau mengatur properti gambar |
| Link | string | Mendapatkan atau mengatur tautan ke instans entitas |
| Nama | string | Mendapatkan atau mengatur properti nama |
| Gambar | string | Mendapatkan atau mengatur atribut gambar |
Kelas FacebookPicture
Kelas untuk menyajikan data gambar yang dikembalikan dari penyedia layanan
Karakteristik
| Harta benda | Tipe | Description |
|---|---|---|
| Nomor Identitas | string | Mendapatkan atau mengatur ID gambar |
| Is_Silhouette | bool | Mendapatkan atau menetapkan nilai yang menunjukkan apakah gambar adalah siluet atau tidak |
| Link | string | Mendapatkan atau mengatur URL halaman yang berisi gambar |
| URL | string | Mengambil atau menetapkan URL ke gambar |
Kelas FacebookPictureData
Menyimpan data gambar
Karakteristik
| Harta benda | Tipe | Description |
|---|---|---|
| Data Informasi | Gambar Facebook | Mendapatkan atau mengatur properti data |
Kelas FacebookPlatformImageSource
Menyimpan detail gambar
Karakteristik
| Harta benda | Tipe | Description |
|---|---|---|
| Tinggi | string | Mendapatkan atau mengatur properti tinggi |
| Sumber | string | Mendapatkan atau mengatur properti sumber |
| Lebar | string | Mendapatkan atau mengatur atribut lebar |
Kelas FacebookPost
Menyimpan data postingan facebook
Karakteristik
| Harta benda | Tipe | Description |
|---|---|---|
| Nomor Identitas | string | Mendapatkan atau mengatur properti id |
| Message | string | Mengambil atau menetapkan pesan atau teks posting |
| Waktu_Dibuat | DateTime | Mendapatkan atau mengatur waktu instans entitas dibuat |
| Link | string | Mendapatkan atau mengatur tautan ke instans entitas |
| Gambar_Utuh | string | Mendapatkan atau mengatur tautan ke gambar yang menyertainya |
FacebookRequestSource<Kelas T>
Tipe untuk menangani permintaan berhalaman ke Graph API Facebook
Pembangun
| Pembangun | Description |
|---|---|
| FacebookRequestSource(FacebookDataConfig, string, string, int) | Menginisialisasi kelas FacebookRequestSource<T> baru |
Methods
| Methods | Jenis Hasil | Description |
|---|---|---|
| GetPagedItemsAsync(int, int, CancellationToken) | Tugas<IEnumerable<T>> | Mengembalikan halaman data dengan tipe yang kuat |
Kelas FacebookService
Kelas untuk menyambungkan ke Facebook
Karakteristik
| Harta benda | Tipe | Description |
|---|---|---|
| WindowsStoreId | string | Mendapatkan ID Windows Store untuk aplikasi saat ini |
| Kasus | FacebookService | Mendapatkan properti singleton publik |
| LoggedUser | string | Mendapatkan nama pengguna yang dicatat saat ini |
| Provider | FBSession | Mendapatkan referensi ke instans penyedia data yang mendasar |
| B | int | Description |
| B | int | Description |
Methods
| Methods | Jenis Hasil | Description |
|---|---|---|
| Initialize(FacebookOAuthTokens, FacebookPermissions) // Inisialisasi token dan izin OAuth Facebook | bool | Menginisialisasi penyedia dasar dengan informasi token yang relevan |
| LoginAsync() | Tugas<bool> | Masuk dengan set requiredPermissions yang diperlukan |
| LogoutAsync() | Task | Keluar dari instans layanan dasar |
| RequestAsync(FacebookDataConfig, int) | Daftar<Tugas<FacebookPost>> | Meminta data daftar dari penyedia layanan berdasarkan konfigurasi/kueri tertentu |
| RequestAsync<T>(FacebookDataConfig, int, string) | Daftar<Tugas<T>> | Meminta data daftar dari penyedia layanan berdasarkan konfigurasi/kueri tertentu |
| RequestAsync(FacebookDataConfig, int, int) | Tugas<InkrementalLoadingCollection<FacebookRequestSource<FacebookPost>, FacebookPost>> | Meminta data daftar dari penyedia layanan berdasarkan konfigurasi/kueri tertentu |
| RequestAsync<T>(FacebookDataConfig, int, int, string) | Task<IncrementalLoadingCollection<FacebookRequestSource<T>, T>> | Meminta data daftar generik dari penyedia layanan berdasarkan konfigurasi/kueri tertentu |
| GetUserPictureInfoAsync() | Tugas<FacebookPicture> | Mengembalikan objek FacebookPicture yang terkait dengan pengguna yang masuk |
| GetUserAlbumsAsync(int, string) | Daftar<Tugas<FacebookAlbum>> | Mengambil daftar album foto pengguna |
| GetUserAlbumsAsync(int, int, string) | Task<IncrementalLoadingCollection<FacebookRequestSource<FacebookAlbum>, FacebookAlbum>> | Mengambil daftar album foto pengguna |
| GetUserPhotosByAlbumIdAsync(string, int, string) | Daftar<Tugas<FacebookPhoto>> | Mengambil daftar foto pengguna menurut id album |
| GetUserPhotosByAlbumIdAsync(string, int, int, string) | Task<IncrementalLoadingCollection<FacebookRequestSource<FacebookPhoto>, FacebookPhoto>> | Mengambil daftar foto pengguna menurut id album |
| GetPhotoByPhotoIdAsync(string) | Tugas <FacebookPhoto> | Memperoleh foto berdasarkan id |
| PostToFeedWithDialogAsync(string) | Tugas<bool> | Memungkinkan memposting data ke garis waktu menggunakan dialog Facebook |
Proyek Sampel
Sumber Halaman Sampel Layanan Facebook. Anda dapat melihat tindakan ini diAplikasi Sampel Toolkit Komunitas Windows.
Persyaratan
| Rangkaian perangkat | Universal, 10.0.16299.0 atau lebih tinggi |
|---|---|
| Namespace | Microsoft.Toolkit.Uwp.Services |
| Paket NuGet | Microsoft.Toolkit.Uwp.Services |
API
.NET Community Toolkit