Pemberitahuan Deprecation
Chatengine telah digunakan tanpa rencana untuk rilis tambahan. Dukungan untuk Chatengine SDK akan berakhir pada 16 Juli 2021. Jika Anda memiliki pertanyaan tentang Chatengine, silakan hubungi kami di [email protected]. Silakan kunjungi produk obrolan baru kami, obrolan pubnub.
Pubnub Chatengine Framework
PubNub Chatengine adalah kerangka kerja berbasis emitor acara berorientasi objek untuk membangun aplikasi obrolan di JavaScript. Ini mengurangi waktu untuk membangun aplikasi obrolan secara drastis dan menyediakan komponen -komponen penting seperti indikator pengetikan, pemantauan kehadiran online dan riwayat pesan di luar kotak.
Komponen server real-time disediakan oleh PubNub. Chatengine dirancang agar dapat diperluas dan mencakup kerangka kerja plugin untuk membuat penambahan fitur baru sederhana.
Untuk informasi lebih lanjut tentang membangun aplikasi obrolan dengan PubNub, lihat pusat sumber daya obrolan kami.
Dokumentasi
Anda dapat menemukan dokumen lengkap di situs web dokumentasi.
Memulai
Prasyarat
- NodeJS
- Bootstrap Twitter
- jQuery
- Es6
PUBNUB Account
Untuk mengatur chatengine di pubnub, pertama -tama harus mengatur kunci pubnub. Langkah-langkah berikut menguraikan cara mengatur kunci pubnub secara manual untuk bekerja dengan SDK sisi klien chatengine.
Daftar untuk akun pubnub
Jika Anda belum memiliki akun, Anda dapat membuatnya secara gratis di sini.
Siapkan Layanan API REST menggunakan fungsi pubnub
Kerangka Chatengine dan SDK sisi klien berinteraksi dengan layanan API REST yang berjalan sebagai fungsi pubnub.
Anda harus mengatur fungsi di akun pubnub Anda sebelum Anda dapat menggunakan SDK.
Ikuti instruksi penyiapan server chatengine.
Kode unduh
Buat proyek NPM baru
Karena kami akan menginstal dependensi, akan sangat membantu untuk membuat package.json baru.json untuk melacak semua paket yang akan kami instal.
Di direktori proyek Anda, jalankan perintah ini untuk membuat paket baru. Lengkapi panduan pengaturan interaktif dan kami akan siap untuk pergi.
Itu akan membuat package.json di direktori proyek Anda.
{
"name" : " chat-engine-tutorial " ,
"version" : " 0.0.1 " ,
"description" : " An example PubNub ChatEngine Tutorial " ,
"main" : " index.js " ,
"author" : " Ian Jennings "
} Instal Pubnub Chatengine
Baiklah, sekarang untuk bagian yang mungkin belum pernah Anda lakukan sebelumnya! Instal Pubnub Chatengine dengan menjalankan:
npm install chat-engine@latest --save
Sumber daya tambahan
Plugin
Lihatlah wastafel dapur jQuery dan contoh wastafel dapur sudut untuk melihat plugin beraksi.
- Image Uneads - Gunakan layanan UploadCare untuk mengunggah gambar dan membuatnya dalam obrolan. Contoh.
- Dukungan Markdown - Render Markdown dalam HTML Saat menerima pesan. Contoh.
- Pengguna Mute - Memungkinkan pengguna saat ini untuk berhenti menerima acara dari pengguna lain. Contoh.
- Pencarian Pengguna Online - Cara sederhana untuk mencari melalui daftar pengguna secara online dalam obrolan. Contoh.
- Indikator Pengetikan - Menyediakan metode kenyamanan yang menyala ketika pengguna mulai atau berhenti mengetik. Contoh
- Pesan yang belum dibaca - memungkinkan Anda untuk menandai obrolan sebagai berada di latar belakang dan menambah penghitung saat acara dikirim ke sana. Contoh.
- Pemberitahuan Desktop - Menggunakan HTML5 Notification API untuk mengirim pembaruan "pemanggang roti".
- Dukungan emoji - menggunakan gambar sebagai fallback untuk perangkat yang mungkin belum mendukung?
- Status Acara dan Baca Kwitansi - Memancarkan acara tambahan ketika seseorang membaca menerima dan/atau membaca pesan.
- Dukungan Gravatar - Menggunakan Layanan Gravatar untuk membuat avatar berdasarkan informasi keadaan pengguna.
- Nama Pengguna Acak- Plugin yang memberi setiap pengguna nama pengguna acak menggabungkan warna dan hewan.
Video
- Intro Chatengine
- Tutorial Chatengine 5 Menit
- Mengobrol dalam 30 baris kode webinar
Tutorial
Javascript
- Memulai tutorial.
- Obrolan - Contoh obrolan yang sangat sederhana. "Dunia halo" dari Chatengine.
- Daftar Online - Tidak ada obrolan, cukup render siapa yang online. Lihat wastafel dapur untuk cara menggabungkan ini dengan obrolan pribadi.
Bereaksi Native + Mobile
- React Native Contoh-Dibuat dengan
create-react-app . - React Native Components - Komponen premade untuk membuat obrolan, pesan, pengguna, dan banyak lagi.
- Mengintegrasikan ke dalam aplikasi iOS yang ada - Panduan untuk menambahkan aplikasi asli Chatengine React ke iOS.
- Mengintegrasikan ke dalam aplikasi Android yang ada - Panduan untuk menambahkan aplikasi asli Chatengine React di Android.
Bereaksi
- React - Bare Bones React Web Contoh.
Vue
- Vue Guide - Panduan Menggunakan Chatengine dan Vue Bersama. Menggunakan sumber daya berikut.
- Contoh Vue - Contoh CHATENGINE VUE DENGAN LENGKAP.
- Plugin Vue - Plugin Chatengine untuk Vue.
Angular
- Aplikasi Angular Simple - Angular "Hello World". Aplikasi sederhana yang menggunakan plugin sudut kustom untuk dirender saat ada yang diperbarui.
- Angular Kitchen Wastafel - Aplikasi demo terbesar di luar sana, hampir klon obrolan tim desktop lengkap (Slack, Stire, Flowdock). URL yang gigih dan masuk ke aplikasi desktop nyata dengan elektron!
jQuery
- JQuery Simple - Aplikasi JQuery Chatengine "Hello World". Aplikasi sederhana di mana semua orang mengobrol bersama.
- JQuery Kitchen Wastafel - Contoh besar yang menggunakan sebagian besar fitur chatengine. Memiliki daftar online yang memunculkan obrolan baru saat Anda mengklik nama pengguna.
Otentikasi pihak ke -3
- Facebook Login - Gunakan profil Facebook dengan chatengine.
NodeJs + chatbot
- NODEJS CHATBOT - Contoh bot yang menanggapi pesan dan meniru pengetikan. Bekerja dengan contoh wastafel dapur jQuery secara default.
Perkembangan
Kloning
Klon Repo (mesin obrolan dan plugin).
Semua repo harus satu sama lain. Ini diperlukan untuk memberikan dokumen dengan benar.
chat-engine
chat-engine-desktop-notifications
chat-engine-emoji
chat-engine-examples
//...
Menyiapkan Lingkungan
Jalankan http-server dari direktori saya /development yang memiliki semua repo mesin obrolan:
cd chat-engine
node server.js
Muat http: // localhost: 8080 di browser dan navigasikan ke/chat-engine-elicles/jQuery/dapur-sink
Menyusun
Jalankan gulp untuk mengkompilasi, tetapi Anda mungkin harus menjalankan gulp watch untuk mendapatkan perubahan yang konsisten.
Menjalankan tes
Anda perlu menetapkan variabel lingkungan PUB_KEY_0 dan SUB_KEY_0 ke kunci pubnub Anda sendiri. Tambahkan variabel -variabel ini ke dalam .bashrc atau .zshrc Anda.
# pubnub chatengine keys
export PUB_KEY_0= " YOUR PUBNUB PUBLISH KEY "
export SUB_KEY_0= " YOUR PUBNUB SUBSCRIBE KEY "
Kemudian, di folder root run:
Melepaskan tambalan (mesin obrolan dan plugin)
npm version patch && git push origin master --tags
Mendukung
- Jika Anda memerlukan bantuan , miliki pertanyaan umum , atau untuk mengajukan bug , hubungi [email protected]