Chia sẻ lên Messenger dành cho iOS và Android

Khi phát triển bằng Facebook SDK dành cho iOS hoặc Android phiên bản 4.29.0 trở lên, bạn có thể cho phép mọi người chia sẻ cả liên kết lẫn file phương tiện với Messenger từ ứng dụng của bạn. Khi người dùng chia sẻ lên Messenger, bạn có thể kích hoạt tiện ích chat thông qua liên kết ghi nhận. Tiện ích chat của bạn sẽ xuất hiện trong phần Xem thêm của giao diện chia sẻ.

Để biết thêm thông tin, hãy xem các phần sau:

Loại chia sẻ
Liên kết ID ứng dụng và ID Trang
Đăng ký miền
iOS
Android

Để triển khai tính năng chia sẻ lên Messenger dành cho web, hãy xem phần Chia sẻ lên Messenger dành cho web.

Loại chia sẻ

Facebook SDK cung cấp các loại chia sẻ sau:

Chia sẻ liên kết (Giống với tính năng chia sẻ liên kết hiện có nhưng sử dụng pageID để ghi nhận)
Ảnh (Không được ghi nhận)

Bảng sau đây nêu tất cả các loại chia sẻ được hỗ trợ trong tính năng chia sẻ lên Messenger, cùng với thông tin cho biết có yêu cầu ID Trang hoặc ID ứng dụng hay không.

Loại chia sẻ	Yêu cầu ID Trang?	Ứng dụng
Chia sẻ liên kết	Không bắt buộc	Liên kết không có ghi nhận Liên kết có ghi nhận
Ảnh	Không được hỗ trợ	Ảnh Ảnh từ thư viện

Liên kết ID ứng dụng và ID Trang

Nhà phát triển có thể chỉ định ID Trang trong quy trình chia sẻ và khi mọi người chia sẻ nội dung với Messenger từ một ứng dụng bằng SDK Chia sẻ, nội dung đó sẽ được ghi nhận cho Trang. Từ đó, quản trị viên Trang có thể ngăn chặn ghi nhận giả mạo bằng cách kiểm soát những ứng dụng nào có thể sử dụng quyền ghi nhận chia sẻ cho Trang của họ. Để cấp cho một ứng dụng quyền ghi nhận chia sẻ, quản trị viên sẽ liên kết ID ứng dụng với ID Trang.

Cách liên kết ID ứng dụng và ID Trang:

Chuyển đến phần Cài đặt của Trang.
Nhấp vào phần Nền tảng Messenger.
Chuyển đến phần Liên kết ứng dụng trong Cài đặt chung.
Nhập ID ứng dụng rồi nhấp vào nút Liên kết.
Nếu ứng dụng này KHÔNG có trong bảng Ứng dụng đã đăng ký, ứng dụng sẽ hiển thị trong bảng có vai trò "ghi nhận chia sẻ" được liên kết với ứng dụng đó. Nếu ứng dụng đã có trong bảng này, vai trò "ghi nhận chia sẻ" mới sẽ được thêm cho ứng dụng đó.

Quản trị viên Trang cũng có thể gỡ quyền sử dụng vai trò ghi nhận chia sẻ của ứng dụng.

Cách gỡ vai trò "ghi nhận chia sẻ" của một ứng dụng cụ thể:

Trong bảng Ứng dụng đã đăng ký, hãy nhấp vào menu thả xuống trong cột "vai trò" của ứng dụng đó.
Nhấp vào "ghi nhận chia sẻ" để bỏ chọn vai trò.
Nếu "ghi nhận chia sẻ" là vai trò duy nhất của ứng dụng, hàng của ứng dụng đó sẽ bị gỡ khỏi bảng. Nếu không, hàng đó vẫn giữ nguyên nhưng hàng "ghi nhận chia sẻ" sẽ bị bỏ chọn.

Đăng ký miền

Nếu bạn sử dụng một nút URL trong SDK Chia sẻ và muốn bật Tiện ích Messenger cho URL đó khi mở trong Messenger, bạn phải đăng ký miền URL đó để nội dung chia sẻ hoạt động chính xác.

Cách đăng ký miền:

Xem Trang.
Chuyển đến phần Cài đặt > Nhắn tin nâng cao.
Thêm miền vào trường Miền nằm trong danh sách hợp lệ.

Để biết thêm thông tin, hãy xem phần SDK Tiện ích Messenger - Yêu cầu đưa miền vào danh sách hợp lệ.

iOS

Điều kiện tiên quyết

Trước khi bạn thêm tính năng chia sẻ với Messenger vào ứng dụng của mình, hãy hoàn thành các bước sau:

Thêm Facebook SDK dành cho iOS vào môi trường phát triển di động của bạn
Đặt cấu hình và liên kết ID ứng dụng Facebook với ID Trang bằng công cụ Nền tảng Messenger.
Thêm ID ứng dụng, tên hiển thị và lý do ở định dạng con người đọc được về quyền truy cập ảnh cho file .plist của ứng dụng.
Liên kết FBSDKShareKit.framework với dự án của bạn.

Để biết thêm thông tin, hãy xem phần Bắt đầu sử dụng Facebook SDK dành cho iOS

Đồng thời, đảm bảo rằng ứng dụng của bạn gọi canShow hoặc validate trên phiên bản MessageDialog để xác định xem mọi người đã cài đặt phiên bản Messenger tương thích trên thiết bị của họ hay chưa.

Các giới hạn

Không hỗ trợ thuộc tính trích dẫn.

Ví dụ về chia sẻ liên kết

guard let url = URL(string: "https://newsroom.fb.com/") else {
    preconditionFailure("URL is invalid")
}

let content = ShareLinkContent()
content.contentURL = url

let dialog = MessageDialog(content: content, delegate: self)

do {
    try dialog.validate()
} catch {
    print(error)
}

dialog.show()

Ví dụ về chia sẻ ảnh

// Assumes your assets contain an image named "puppy"
guard let image = UIImage(named: "puppy") else {
    return
}

let photo = SharePhoto(image: image, userGenerated: true)
let content = SharePhotoContent()
        content.photos = [photo]

let dialog = MessageDialog(content: content, delegate: self)

// Recommended to validate before trying to display the dialog
do {
    try dialog.validate()
} catch {
    print(error)
}

dialog.show()

Ví dụ về chia sẻ video

// Assuming you have a URL for a PHAsset
let video = ShareVideo(videoURL: assetURL)
let content = ShareVideoContent()
content.video = video

let dialog = MessageDialog(content: content, delegate: self)

// Recommended to validate before trying to display the dialog
do {
    try dialog.validate()
} catch {
    print(error)
}

dialog.show()

Android

Điều kiện tiên quyết

Làm theo hướng dẫn trong phần Chia sẻ trên Android, được tóm tắt bên dưới:

Để sử dụng SDK Chia sẻ trên Facebook trong dự án của bạn, hãy biến SDK này thành phần phụ thuộc trong Maven hoặc tải xuống.
Lấy ID ứng dụng Facebook được đặt cấu hình và liên kết đúng cách với ứng dụng Android của bạn.
Đặt cấu hình và liên kết ID ứng dụng Facebook với ID Trang bằng công cụ Nền tảng Messenger.
Tạo Hash khóa trên Android rồi thêm hash đó vào trang cá nhân nhà phát triển của bạn.
Thêm một Hoạt động trên Facebook và đưa hoạt động đó vào file AndroidManifest.xml

Đồng thời đảm bảo rằng ứng dụng của bạn gọi MessageDialog.canshow({template}) để xác định xem mọi người đã cài đặt phiên bản Messenger tương thích trên thiết bị của họ hay chưa.

Chủ đề liên quan

Chia sẻ với Messenger dành cho web