Giới thiệu
Trong tháng 8 năm 2025, chúng tôi đã thực hiện nhiều cải tiến quan trọng để làm cho tài liệu của mình đáng tin cậy hơn và dễ sử dụng hơn hàng ngày. Những thay đổi này không chỉ giúp các nhà phát triển dễ dàng hơn trong việc xây dựng ứng dụng mà còn cải thiện trải nghiệm người dùng. Dưới đây là những điểm nổi bật và cải tiến trong tài liệu của chúng tôi.
Nội dung chính
- Cải thiện cách thức đăng ký wildcard và giới hạn về Presence.
- Tổ chức lại tài liệu mã hóa thành các trang SDK hạng nhất.
- Thêm hướng dẫn quản lý kết nối cho SDK Chat.
- Cập nhật mô hình phân trang cho Events & Actions.
- Tài liệu SDK PHP và Unreal giờ đây lấy ví dụ trực tiếp từ GitHub.
Những Cải Tiến Đáng Chú Ý
Cải tiến tài liệu thông báo đẩy
Loại: Nâng cấp
Chúng tôi đã cập nhật tài liệu cho iOS (APNS) và Android (FCM) để cho thấy cách loại trừ người gửi khỏi việc nhận thông báo cho chính tin nhắn của họ. Cụ thể, APNS sử dụng excluded_devices và FCM sử dụng pn_exceptions. Bên cạnh đó, chúng tôi cũng làm rõ rằng việc đăng ký thông báo trên di động nhắm đến các kênh riêng lẻ thay vì nhóm kênh.
Hành vi đăng ký wildcard và hạn chế Presence
Loại: Nâng cấp
Chúng tôi đã làm rõ hai lĩnh vực trong tài liệu SDK và API:
- Gọi
subscribe()mở kết nối nhưng bạn vẫn cần có listener sự kiện để nhận tin nhắn. Với các đăng ký wildcard, các đối tượng tin nhắn bao gồm người gửi trongpublisher, kênh thực tế trongchannel, và khớp wildcard trongsubscription. - Tài liệu về Presence hiện đã ghi rõ rằng wildcard không được hỗ trợ cho các nhóm kênh - hãy sử dụng tên nhóm chính xác.
Tổ chức lại tài liệu mã hóa
Loại: Nâng cấp
Mã hóa đã được chuyển sang một trang tài liệu API hạng nhất trong mỗi SDK. Nội dung đã được làm mới để dễ tìm và áp dụng hơn. Các trang mới bao gồm cấu hình mô-đun mã hóa SDK, tùy chọn 128-bit và 256-bit AES-CBC, và các ví dụ mã hóa/giải mã cập nhật.
Quản lý kết nối trong SDK Chat Kotlin và JavaScript
Loại: Nâng cấp
Chúng tôi đã thêm tài liệu quản lý kết nối cho SDK Chat Kotlin và JavaScript. Các tài liệu này giới thiệu một listener trạng thái kết nối (ONLINE/OFFLINE/ERROR) và các phương pháp để ngắt và kết nối lại các đăng ký, kèm theo các ví dụ mã và quy trình làm việc được đề xuất để xử lý lỗi và khôi phục kết nối.
Cập nhật thông tin ghi log và thông tin thử lại đăng ký trong tài liệu SDK Dart
Loại: Nâng cấp
Chúng tôi đã tài liệu hóa thông tin ghi log và thử lại đăng ký trong SDK Dart. Bạn có thể thấy những gì đang xảy ra và phục hồi một cách thanh lịch. Bạn có thể kích hoạt ghi log có cấu trúc và điều chỉnh độ chi tiết tại thời gian chạy.
Ví dụ từ SDK trong tài liệu SDK PHP và Unreal
Loại: Nâng cấp
Chúng tôi đã tiếp tục phát triển ví dụ từ kho, luôn cập nhật và đồng bộ hóa giữa các SDK. Tài liệu SDK PHP và Unreal hiện lấy ví dụ trực tiếp từ các kho GitHub của chúng tôi.
Cập nhật tài liệu API cho Events & Actions
Loại: Nâng cấp
Chúng tôi đã cập nhật tài liệu tham khảo API cho Events & Actions với mô hình phân trang tiêu chuẩn hóa và một danh mục loại tin nhắn mới. Chúng tôi cũng đã thêm các tham số tùy chọn subkey và account_id nơi cần thiết.
Tính năng mới: Giám sát nội dung tự động
Loại: Tính năng mới
Nếu bạn sử dụng Auto Moderation, Giám sát Kênh giờ đây có phần Nội dung Tự động Được Kiểm Duyệt để xem xét nội dung bị chặn tự động. Bạn có thể lọc theo loại và cung cấp phản hồi cho chúng tôi để cải thiện khả năng phát hiện.
Tùy chỉnh giao diện Illuminate
Loại: Nâng cấp
Nếu bạn nhúng giao diện Illuminate trên một trang web bên ngoài, giờ đây bạn có thể tạo chủ đề để phù hợp với thương hiệu của mình. Tài liệu bao gồm ví dụ iframe hoàn chỉnh và các tùy chọn chủ đề rõ ràng.
Tại sao chọn Markdown cho tài liệu
Loại: Cải tiến
Chúng tôi hiện xuất bản một phiên bản Markdown dễ đọc cho mọi trang tài liệu. Markdown giúp cấu trúc các tiêu đề, danh sách, bảng và mã nguồn một cách dễ dàng, đồng thời giảm thiểu “nhiễu” trên trang.
Mẹo và Thực hành Tốt Nhất
- Kiểm tra thường xuyên: Đảm bảo bạn thường xuyên kiểm tra tài liệu để nắm bắt những thay đổi mới nhất.
- Sử dụng ví dụ thực tế: Hãy sử dụng các ví dụ thực tế để minh họa cho các khái niệm kỹ thuật.
- Thực hành tốt nhất về bảo mật: Luôn sử dụng các phương pháp mã hóa mạnh mẽ nhất và cập nhật định kỳ.
Câu hỏi thường gặp (FAQ)
Hỏi: Làm thế nào để tôi có thể yêu cầu quyền truy cập vào API Events & Actions?
Đáp: Để yêu cầu quyền truy cập, hãy liên hệ với bộ phận hỗ trợ của PubNub.
Hỏi: Có cách nào để tôi tự quản lý nội dung tự động không?
Đáp: Có, bạn có thể chọn phương pháp tự quản lý trong tài liệu Auto Moderation.
Kết luận
Chúng tôi rất vui mừng về những cải tiến này và hy vọng rằng chúng sẽ mang lại trải nghiệm tốt hơn cho các nhà phát triển. Hãy thường xuyên truy cập tài liệu của chúng tôi để cập nhật những thay đổi mới nhất và tối ưu hóa quy trình phát triển của bạn. Nếu bạn có bất kỳ câu hỏi nào, đừng ngần ngại liên hệ với bộ phận hỗ trợ của chúng tôi!
