Bagikan melalui


Facebook (Diarsipkan)

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

  1. Untuk mendapatkan Facebook.WindowsStoreID, buka: https://developers.facebook.com/apps.
  2. Pilih Buat ID Aplikasi Baru, untuk memulai integrasi Facebook ke aplikasi atau situs web Anda.
  3. Klik, Buat Aplikasi Baru
  4. Dari Dasbor aplikasi pilih item Pengaturan di sebelah kiri. Ini harus memilih item Dasar di bawahnya secara default.
  5. +Tambahkan Platform pilih Aplikasi Windows. Biarkan entri Namespace dan Domain Aplikasi kosong.
  6. Masukkan Windows Store SID dari dalam aplikasi Anda (lihat bagian Mendapatkan Windows Store SID)
  7. 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