Beranda>Terkait pemrograman>Kode sumber lainnya
Unduh

buletin

Pemberitahuan yang dapat disesuaikan untuk Fivem. Meniru pemberitahuan GTAV asli, tetapi memungkinkan lebih banyak penyesuaian

Fitur

  • Tidak ada perpustakaan eksternal
  • JS modern - tidak ada jQuery bloat
  • Posisi layar yang dapat disesuaikan
  • Kustomisasi tampilan dengan menambahkan overrides css Anda sendiri ke ui/css/custom.css
  • Animasi Auto-Arrange
  • Mendukung GTA Default: V dan Gambar Pemberitahuan Kustom
  • Mendukung antrian
  • Mendukung penumpukan
  • Mendukung pinning
  • Mendukung kode warna ( ~r~ , ~b~ , ~h~ , dll)
  • Mendukung HTML sebagai pesan

Video demo

  • Tema
  • Posisi
  • Animasi Auto-Arrange
  • Antri
  • Menumpuk
  • Foto khusus
  • Format

Daftar isi

  • Penggunaan
    • Pemberitahuan standar
    • Pemberitahuan lanjutan
    • Pemberitahuan yang disematkan
  • Fungsi pembantu
  • Acara Server
  • Parameter
  • Konfigurasi default
  • Gambar pemberitahuan khusus
  • Suara pemberitahuan
  • Format
  • Pemberitahuan yang disematkan
  • ESX mengesampingkan
  • Untuk melakukan / direncanakan

Penggunaan

Pemberitahuan standar 

 exports . bulletin : Send ( message , timeout , position , progress , theme , exitAnim , flash )

-- or 

exports . bulletin : Send ({
    message = ' Message ' ,
    timeout = 5000 ,
    theme = ' success '
    ...
})

Pemberitahuan lanjutan 

 exports . bulletin : SendAdvanced ( message , title , subject , icon , timeout , position , progress , theme , exitAnim , flash )

-- or

exports . bulletin : SendAdvanced ({
    message = ' Some Message ' ,
    title = ' Some Title ' ,
    subject = ' Some Subtitle ' ,
    icon = ' CHAR_BANK_MAZE ' ,
    ...
})

Pemberitahuan yang disematkan 

 local pinID = exports . bulletin : SendPinned ({
    type = ' advanced ' , -- or 'standard'
    message = ' This is pinned! ' ,
    title = ' Title ' ,
    subject = ' Subject ' ,
    icon = ' CHAR_BANK_MAZE '
})

-- unpin
exports . bulletin : Unpin ( pinID )

-- unpin multiple
exports . bulletin : Unpin ({ pinID1 , pinID2 , pinID3 , ... })

-- unpin all
exports . bulletin : Unpin ()

-- update content
exports . bulletin : UpdatePinned ( pinID , options )

Fungsi pembantu

Ini adalah metode steno untuk mengirimkan pemberitahuan bertema. Mereka mengambil params / tabel yang sama dengan metode Send() : 

 -- Send standard success notification
exports . bulletin : SendSuccess ( ... )

-- Send standard info notification
exports . bulletin : SendInfo ( ... )

-- Send standard warning notification
exports . bulletin : SendWarning ( ... )

-- Send standard error notification
exports . bulletin : SendError ( ... )

Acara Server

Semua metode dapat dipicu dari klien dan server: 

 -- standard
TriggerClientEvent ( ' bulletin:send ' , source , ... )

-- advanced
TriggerClientEvent ( ' bulletin:sendAdvanced ' , source , ... )

Parameter

Ini dilewati sebagai param individu atau dalam tabel:

param jenis bawaan opsi opsional keterangan
message string TIDAK Pesan untuk dikirim. Bisa berupa string atau html yang valid
timeout integer 5000 YA Durasi dalam ms untuk menampilkan pemberitahuan
position string "bottomleft" "bottomleft" , "topleft" , "topright" TopRight", "bottomright" , "bottom" , "top" YA Posisi pemberitahuan
progress boolean false true , false YA Apakah akan menampilkan kemajuan batas waktu pemberitahuan
theme string "default" "default" , "success" , "info" , "warning" , "error" YA Tema pemberitahuan
exitAnim string "fadeOut" Lihat animate.css untuk opsi YA Animasi yang digunakan untuk menyembunyikan pemberitahuan
flash boolean false YA Membuat pemberitahuan berkedip
title string TIDAK Judul pemberitahuan (hanya lanjutan)
subject string TIDAK Subjek / Subtitle Pemberitahuan (Hanya Lanjutan)
icon string TIDAK Gambar untuk digunakan (hanya lanjutan)

Konfigurasi default 

 Config . Timeout          = 5000          -- Overridden by the `timeout` param
Config . Position         = " bottomleft "  -- Overridden by the `position` param
Config . Progress         = false         -- Overridden by the `progress` param
Config . Theme            = " default "     -- Overridden by the `theme` param
Config . Queue            = 5             -- No. of notifications to show before queueing
Config . Stacking         = true
Config . ShowStackedCount = true
Config . AnimationOut     = " fadeOut "     -- Default exit animation - overriden by the `exitAnim` param
Config . AnimationTime    = 500           -- Entry / exit animation interval
Config . FlashCount       = 5             -- No. of times the notification blinks when `flash` param is used
Config . SoundFile        = false         -- Sound file stored in ui/audio used for notification sound. Leave as false to disable.
Config . SoundVolume      = 0.4           -- 0.0 - 1.0

Config . Pictures = {
    -- advanced notification icons
}

Gambar pemberitahuan khusus

Untuk menambahkan gambar khusus Anda sendiri, unggah gambar jpg 64x64 ke direktori ui/images dan tambahkan kode khusus dan nama file ke tabel Config.Pictures di config.lua ,

Contoh

Unggah my_custom_icon_image.jpg ke direktori ui/images dan gunakan MY_CUSTOM_ICON_CODE (tidak ada spasi!) Sebagai kunci. 

 Config . Pictures = {
    ...
    MY_CUSTOM_ICON_CODE = " my_custom_icon_image.jpg " -- Add this
}

Kemudian gunakan kode khusus dalam panggilan pemberitahuan: 

 exports . bulletin : SendAdvanced ( " Message " , " Title " , " Subject " , " MY_CUSTOM_ICON_CODE " )

Suara pemberitahuan

Anda dapat mengaktifkan suara pemberitahuan dengan mengunggah file suara khusus ke direktori ui/audio dan mengedit konfigurasi untuk menggunakannya: 

 Config . SoundFile        = ' my_notification_sound.mp3 '
Config . SoundVolume      = 0.4

File audio yang valid: .mp3 , .ogg , .wav

Format

Buletin mendukung pemformatan berikut: 

 n = new line
~ r ~ = Red
~ b ~ = Blue
~ g ~ = Green
~ y ~ = Yellow
~ p ~ = Purple
~ o ~ = Orange
~ u ~ = Black
~ w ~ = White
~ h ~ = Bold Text

Anda juga dapat menggunakan HTML untuk warna: 

 exports . bulletin : Send ( " <span class='r'>I am red</span> and <span class='y'>I am yellow</span> " )

atau html yang Anda suka 

 exports . bulletin : Send ( " <h1>Some Title</h1><p class='paragraph'>Some text</p><footer>Some footer text</footer> " )

Pemberitahuan yang disematkan

Untuk mengirim pemberitahuan yang disematkan, Anda harus menyimpan pin_id pemberitahuan sehingga Anda dapat membatalkannya nanti. 

 local pinID = exports . bulletin : SendPinned ({
    type = ' advanced ' -- or 'standard'
    message = ' This is pinned! '
})

Kemudian untuk membongkar itu hanya meneruskan nilai yang tersimpan ke metode Unpin() : 

 exports . bulletin : Unpin ( pinID )

Metode Unpin() juga menerima table ID pin: 

 exports . bulletin : Unpin ({ pinned1 , pinned2 , pinned3 })

atau hilangkan param untuk unpin semua: 

 exports . bulletin : Unpin ()

Anda juga dapat memperbarui konten pemberitahuan yang disematkan: 

 -- Send pinned notification
local pinID = exports . bulletin : SendPinned ({
    type = ' advanced ' ,
    message = ' This is pinned! ' ,
    title = ' Title ' ,
    subject = ' Subject ' ,
    icon = ' CHAR_BANK_MAZE ' ,
    theme = ' success '
})

-- Update it's content
exports . bulletin : UpdatePinned ( pinID , {
    message = ' Updated message! ' ,
    title = ' Updated title ' ,
    subject = ' Updated subject ' ,
    icon = ' CHAR_TREVOR ' ,
    theme = ' error ' ,
    flash = true
})

Hanya message , title , subject , icon , theme , dan opsi flash yang dapat diperbarui saat ini.

Pemberitahuan yang disematkan tidak mengantri jadi, misalnya, jika Anda mengatur Config.Queue ke 5 dan Anda memiliki 2 pemberitahuan yang disematkan, Anda akan mendapatkan maks 7 pemberitahuan yang ditampilkan kapan saja.

ESX mengesampingkan

Jika Anda menggunakan ESX maka Anda bisa mendapatkan bulletin untuk mengganti pemberitahuan dengan mengedit fungsi yang sesuai di es_extended/client/functions.lua : 

 ESX . ShowNotification = function ( msg )
    -- SetNotificationTextEntry('STRING')
    -- AddTextComponentString(msg)
    -- DrawNotification(0,1)
	
    exports . bulletin : Send ( msg )
end

ESX . ShowAdvancedNotification = function ( sender , subject , msg , textureDict , iconType , flash , saveToBrief , hudColorIndex )
    -- if saveToBrief == nil then saveToBrief = true end
    -- AddTextEntry('esxAdvancedNotification', msg)
    -- BeginTextCommandThefeedPost('esxAdvancedNotification')
    -- if hudColorIndex then ThefeedNextPostBackgroundColor(hudColorIndex) end
    -- EndTextCommandThefeedPostMessagetext(textureDict, textureDict, false, iconType, sender, subject)
    -- EndTextCommandThefeedPostTicker(flash or false, saveToBrief)
	
    exports . bulletin : SendAdvanced ( msg , sender , subject , textureDict )
end

Untuk melakukan / direncanakan

  • Kurangi jumlah param yang mendukung tabel opsi
  • Dukungan penumpukan
  • SUARA PEMBERITAHUAN DUKUNGAN
  • Dukungan Pemberitahuan yang disematkan
  • Mendukung animasi entri yang ditentukan pengguna (saat ini hanya mendukung animasi keluar)




Pemberitahuan hukum

buletin

Hak Cipta (C) 2021 Mobius1

Program ini adalah perangkat lunak gratis: Anda dapat mendistribusikannya kembali dan/atau memodifikasinya berdasarkan ketentuan lisensi publik umum GNU seperti yang diterbitkan oleh Yayasan Perangkat Lunak Gratis, baik versi 3 lisensi, atau (pada opsi Anda) versi selanjutnya.

Program ini didistribusikan dengan harapan akan bermanfaat, tetapi tanpa jaminan apa pun; bahkan tanpa jaminan tersirat dari dapat diperjualbelikan atau kebugaran untuk tujuan tertentu. Lihat Lisensi Publik Umum GNU untuk lebih jelasnya.

Anda seharusnya menerima salinan Lisensi Publik Umum GNU bersama dengan program ini.
Jika tidak, lihat https://www.gnu.org/licenses/
Memperluas
Informasi Tambahan
Aplikasi Terkait
Direkomendasikan untuk Anda
Informasi Terkait Semua