Kirim API Pesan Langsung

14min

Anda dapat mengirim Pesan Langsung ke pengguna lain di dalam ZEPETO World menggunakan API Kirim Pesan Langsung (DM).
Saat menggunakan API pengiriman Pesan Langsung (DM) di dunia yang diluncurkan, tautan untuk masuk ke dunia secara otomatis disediakan di bagian bawah pesan, menjadikannya baik untuk mempromosikan dunia.
Harap pastikan untuk mengikuti langkah-langkah pencegahan saat menggunakan.
﻿
Instal
Jendela → Pengelola Paket → Paket ZEPETO.World Harap instal versi 1.21.14 atau lebih tinggi terlebih dahulu.
Setelah itu, harap instal paket ‘ZEPETO.Module’ dengan versi 1.0.7 atau lebih tinggi.
Pastikan bahwa aplikasi ZEPETO menjalankan versi 3.46.000 atau lebih tinggi.
﻿
﻿
Kirim API Pesan Langsung
Untuk menggunakan API Kirim DM, tambahkan pernyataan impor di bawah ini.
TypeScript
import { SocialService } from 'ZEPETO.Module.Social';
import { SocialService } from 'ZEPETO.Module.Social';
﻿
﻿
Fungsi inti Kirim DM
Deklarasi
publik statis OpenPopupDirectMessage($sendMessage: string, $userIds?: string[], $onComplete?: System.Action$1):void;
Parameter
parameter
Deskripsi
sendMessage
Ini adalah parameter yang diperlukan. Ini adalah isi pesan yang ingin Anda kirim. Jika kosong atau tidak ada, pengiriman akan dianggap gagal.
userIds
Ini adalah parameter opsional.

Jika Anda mengirim userIds
- UI pemilihan dikonfigurasi dengan daftar ID pengguna yang sesuai.

Ketika userIds tidak dikirim atau daftar kosong dikirim
- UI pemilihan dibangun dengan daftar mengikuti/pengikut dari pengguna yang mengirim pesan.
onComplete
Ini adalah callback yang akan dipanggil ketika pengiriman pesan selesai atau gagal.
StatusPopupPesanLangsung
Respon
Deskripsi
Batal
Ketika pop-up ditutup secara manual atau jika pengiriman gagal.
KirimSelesai
Ketika permintaan kirim selesai dan ditutup.
﻿
Situasi berdasarkan Kode Kesalahan
Respon
Deskripsi
31002
Ini terjadi jika setidaknya satu UserID yang salah (UserID yang tidak ada) disertakan saat memasukkan daftar ID pengguna di parameter userIds.
37011
Ini terjadi ketika Anda mencoba mengirim pesan saat menggunakan akun tamu.
8001
Ini terjadi ketika Anda terus-menerus mengirim pesan yang sama berulang kali. Pesan dapat dikirim sekali setiap 10 detik.
2001
Ini terjadi ketika konten pesan di bidang ‘Kirim’ kosong, hanya berisi spasi, atau melebihi 1000 karakter.
0
Kasus kesalahan koneksi jaringan seperti pemutusan jaringan, ketidakstabilan koneksi, dan situasi kesalahan umum lainnya.
-1
Kesalahan yang tidak dapat diidentifikasi.
﻿
Contoh penggunaan
Masukkan pengirim secara langsung dan kirim
1) Silakan tambahkan tombol Kirim DM ke Canvas.
2) Silakan tulis kode contoh seperti di bawah ini.
TypeScript
import { ZepetoScriptBehaviour } from 'ZEPETO.Script';
import { SocialService, DirectMessagePopupState } from 'ZEPETO.Module.Social';
import { Button } from "UnityEngine.UI";
import { WorldService } from 'ZEPETO.World';
 
export default class SendDirectMessage extends ZepetoScriptBehaviour {
 
    // Variabel untuk menyimpan pesan langsung
    public message: string;
 
    // Array ID pengguna untuk mengirim pesan langsung
    public userIds: string[];
 
    // Referensi ke komponen UI tombol
    public sendDMButton: Button;
 
    Start() {
 
        this.sendDMButton.onClick.AddListener(() => {
 
            // Periksa apakah ID saya termasuk dalam array userIds dan kembali jika termasuk
            if (this.userIds.includes(WorldService.userId)) {
                console.log("userIds berisi userId saya");
                return;
            }
 
            // Buka popup untuk mengirim pesan langsung menggunakan SocialService
            SocialService.OpenPopupDirectMessage(this.message, this.userIds, (popupState: DirectMessagePopupState) => {
 
                // Periksa status popup pesan langsung
                if (popupState === DirectMessagePopupState.Cancel) {
                    console.log("Anda menutup pop-up atau gagal mengirim pesan");
                } else if (popupState === DirectMessagePopupState.SendComplete) {
                    console.log("Pesan DM berhasil dikirim, dan pop-up ditutup.");
                }
            });
        });
    }
}
import { ZepetoScriptBehaviour } from 'ZEPETO.Script';
import { SocialService, DirectMessagePopupState } from 'ZEPETO.Module.Social';
import { Button } from "UnityEngine.UI";
import { WorldService } from 'ZEPETO.World';
 
export default class SendDirectMessage extends ZepetoScriptBehaviour {
 
    // Variabel untuk menyimpan pesan langsung
    public message: string;
 
    // Array ID pengguna untuk mengirim pesan langsung
    public userIds: string[];
 
    // Referensi ke komponen UI tombol
    public sendDMButton: Button;
 
    Start() {
 
        this.sendDMButton.onClick.AddListener(() => {
 
            // Periksa apakah ID saya termasuk dalam array userIds dan kembali jika termasuk
            if (this.userIds.includes(WorldService.userId)) {
                console.log("userIds berisi userId saya");
                return;
            }
 
            // Buka popup untuk mengirim pesan langsung menggunakan SocialService
            SocialService.OpenPopupDirectMessage(this.message, this.userIds, (popupState: DirectMessagePopupState) => {
 
                // Periksa status popup pesan langsung
                if (popupState === DirectMessagePopupState.Cancel) {
                    console.log("Anda menutup pop-up atau gagal mengirim pesan");
                } else if (popupState === DirectMessagePopupState.SendComplete) {
                    console.log("Pesan DM berhasil dikirim, dan pop-up ditutup.");
                }
            });
        });
    }
}
﻿
﻿
3) Setelah menulis skrip, kembali ke editor Unity dan seret tombol di inspector untuk mengaturnya. Masukkan isi pesan dan UserID pengguna target untuk pesan tersebut.
Hingga 20 orang akan ditampilkan di UI, jadi masukkan hingga 20 orang.
4) Ketika Anda menekan Tombol Kirim DM, UI daftar teman akan muncul.
Pilih pengguna target dan klik Kirim.
﻿
﻿
5) Jika pengiriman DM berhasil, UI Toast akan muncul menunjukkan keberhasilan, dan log akan dikeluarkan oleh skrip contoh.
﻿
﻿
6) Juga, DM telah tiba untuk targetUser.
Saat menguji di dunia pra-peluncuran, hanya pesan yang dikirim.
﻿
﻿
Saat menggunakan API pengiriman DM di dunia yang diluncurkan, tautan dunia juga dikirim.
﻿
﻿
Jika terjadi kesalahan, seperti mengirim pesan secara terus-menerus atau konten pesan kosong, pengiriman DM akan diproses sebagai kegagalan.
﻿
﻿
Kirim menggunakan UI daftar berikut/pengikut
1) Silakan tambahkan sebuah Tombol ke Kanvas.
2) Silakan tulis contoh kode seperti di bawah ini.
Jika Anda mengirimkan daftar kosong ke parameter targetUserID, UI daftar berikut/pengikut akan muncul.
TypeScript
import { ZepetoScriptBehaviour } from 'ZEPETO.Script';
import { SocialService, DirectMessagePopupState } from 'ZEPETO.Module.Social';
import { Button } from "UnityEngine.UI";
 
export default class SendDirectMessage extends ZepetoScriptBehaviour {
 
    // Variabel untuk menyimpan pesan langsung
    public message: string;
 
    // Referensi ke komponen UI tombol
    public sendDMButton: Button;
 
    // Variabel privat untuk menyimpan array ID pengguna, diinisialisasi sebagai null
    private emptyIds: string[];
 
 
    Start() {
 
        this.sendDMButton.onClick.AddListener(() => {
 
            // Buka popup untuk mengirim pesan langsung menggunakan SocialService
            // Gunakan konten pesan kelas dan array ID pengguna yang kosong
            SocialService.OpenPopupDirectMessage(this.message, this.emptyIds, (popupState: DirectMessagePopupState) => {
 
                // Periksa status yang dikembalikan dari popup pesan langsung
                if (popupState === DirectMessagePopupState.Cancel) {
                    console.log("Anda menutup pop-up atau gagal mengirim pesan");
                } else if (popupState === DirectMessagePopupState.SendComplete) {
                    console.log("Pesan DM berhasil dikirim, dan pop-up ditutup.");
                }
            });
        });
    }
}
import { ZepetoScriptBehaviour } from 'ZEPETO.Script';
import { SocialService, DirectMessagePopupState } from 'ZEPETO.Module.Social';
import { Button } from "UnityEngine.UI";
 
export default class SendDirectMessage extends ZepetoScriptBehaviour {
 
    // Variabel untuk menyimpan pesan langsung
    public message: string;
 
    // Referensi ke komponen UI tombol
    public sendDMButton: Button;
 
    // Variabel privat untuk menyimpan array ID pengguna, diinisialisasi sebagai null
    private emptyIds: string[];
 
 
    Start() {
 
        this.sendDMButton.onClick.AddListener(() => {
 
            // Buka popup untuk mengirim pesan langsung menggunakan SocialService
            // Gunakan konten pesan kelas dan array ID pengguna yang kosong
            SocialService.OpenPopupDirectMessage(this.message, this.emptyIds, (popupState: DirectMessagePopupState) => {
 
                // Periksa status yang dikembalikan dari popup pesan langsung
                if (popupState === DirectMessagePopupState.Cancel) {
                    console.log("Anda menutup pop-up atau gagal mengirim pesan");
                } else if (popupState === DirectMessagePopupState.SendComplete) {
                    console.log("Pesan DM berhasil dikirim, dan pop-up ditutup.");
                }
            });
        });
    }
}
﻿
﻿
3) Setelah menulis skrip, kembali ke editor Unity dan seret tombol di inspector untuk mengaturnya. Kemudian silakan masukkan isi pesan.
4) Ketika Anda menekan Tombol Kirim DM, UI Mengikuti/Pengikut muncul.
Pilih pengguna target dan klik Kirim. (Hingga 5 orang dapat dipilih)
﻿
﻿
Anda dapat mengirim DM ke hingga 5 orang sekaligus.
Anda tidak dapat mengirim DM kepada diri sendiri.
Jumlah pengguna yang sebenarnya mengikuti/mengikuti mungkin berbeda dari jumlah pengguna yang ditampilkan di pop-up Kirim DM.
Ini karena pengguna yang dapat dipilih difilter dan ditampilkan.
Jika Anda memilih pengguna yang telah memblokir penerimaan DM, itu akan dianggap sebagai kegagalan dan DM tidak akan dikirim.
Jika Anda memanggil API Kirim DM secara sering, itu akan dibatasi dan pengiriman akan gagal.
Anda dapat mengirim sekali setiap 10 detik. Harap berhati-hati agar tidak mengirim DM sembarangan.
Jika pesan yang Anda kirim berisi URL, itu tidak akan berfungsi dengan baik, jadi mengirim pesan yang berisi URL dilarang.
Jika pesan yang dikirim kosong atau tidak ada, itu akan dianggap sebagai kegagalan. Harap pastikan untuk menulis isi pesan.
﻿

parameter	Deskripsi
sendMessage	Ini adalah parameter yang diperlukan. Ini adalah isi pesan yang ingin Anda kirim. Jika kosong atau tidak ada, pengiriman akan dianggap gagal.
userIds	Ini adalah parameter opsional. Jika Anda mengirim userIds - UI pemilihan dikonfigurasi dengan daftar ID pengguna yang sesuai. Ketika userIds tidak dikirim atau daftar kosong dikirim - UI pemilihan dibangun dengan daftar mengikuti/pengikut dari pengguna yang mengirim pesan.
onComplete	Ini adalah callback yang akan dipanggil ketika pengiriman pesan selesai atau gagal.

Respon	Deskripsi
Batal	Ketika pop-up ditutup secara manual atau jika pengiriman gagal.
KirimSelesai	Ketika permintaan kirim selesai dan ditutup.

Respon	Deskripsi
31002	Ini terjadi jika setidaknya satu UserID yang salah (UserID yang tidak ada) disertakan saat memasukkan daftar ID pengguna di parameter userIds.
37011	Ini terjadi ketika Anda mencoba mengirim pesan saat menggunakan akun tamu.
8001	Ini terjadi ketika Anda terus-menerus mengirim pesan yang sama berulang kali. Pesan dapat dikirim sekali setiap 10 detik.
2001	Ini terjadi ketika konten pesan di bidang ‘Kirim’ kosong, hanya berisi spasi, atau melebihi 1000 karakter.
0	Kasus kesalahan koneksi jaringan seperti pemutusan jaringan, ketidakstabilan koneksi, dan situasi kesalahan umum lainnya.
-1	Kesalahan yang tidak dapat diidentifikasi.

Diperbarui 11 Oct 2024

Apakah halaman ini membantu Anda?

SEBELUMNYA

Papan Peringkat

BERIKUTNYA

Mengambil Callback Status Mengikuti dari Layar Daftar Anggota Ruangan