Dokumentace Pulse Phone
Pulse Phone — Rychlý start
Nainstalujte jeden resource s názvem phone. Ponechte svůj stávající framework a podporované scripty; Pulse je při startu rozpozná.
PhoneHub + Pulse je samostatná edice s vlastní licencí a vlastní kopií tohoto telefonu. Pokud jste koupili tuto edici, postupujte místo toho podle jejího vlastního návodu k instalaci: server provozuje jeden telefonní resource.
1. Zkontrolujte svůj server
| Co | Potřeba? |
|---|---|
| Zapnutý OneSync, game build 2699 nebo novější | Povinné |
| Databáze: oxmysql (nebo mysql-async, ghmattimysql) na MariaDB 10.6+ nebo MySQL 8 | Doporučeno. Bez SQL resource si telefon ukládá data do key/value úložiště serveru |
| Jeden voice resource: pma-voice, mumble-voip, SaltyChat, TokoVOIP nebo YACA | Doporučeno. Bez něj se hovory spojí, ale není slyšet zvuk |
| screenshot-basic | Doporučeno, aby fotoaparát mohl ukládat fotky. Funguje standardní resource |
| Framework a inventář | Volitelné. Bez nich telefon běží jako standalone |
Databázi, framework, inventář, voice resource a screenshot-basic spouštějte před Pulse. Správné pořadí najdete v požadavcích a v návodu pro váš framework.
Před prvním startem si zálohujte databázi. Pulse si vytváří vlastní tabulky. Pokud jiný telefon zanechal tabulky se stejnými názvy, přejmenují se na old_<name> (nic se nemaže); podrobnosti jsou v požadavcích.
2. Zkopírujte složku phone
Stáhněte si nákup ze svého účtu Cfx.re. Zkopírujte složku phone obsahující fxmanifest.lua do resources svého serveru. Ponechte jí název. Klíč vašeho serveru musí patřit účtu, který asset vlastní.
Nahráváte přes FTP (hostovaný server): použijte režim Binary (FileZilla: Transfer > Transfer Type > Binary), nebo nahrajte zip a rozbalte ho přímo na serveru. Režim Auto změní zamčené soubory a telefon se odmítne spustit; příznaky a řešení jsou v Řešení problémů. Nahraná složka musí odpovídat této tabulce; kontrola při startu uvede každý soubor, který chybí nebo má špatnou velikost.
Stažený balíček Pulse Phone 1.4.2:
| Složka nebo soubor | Soubory | Velikost |
|---|---|---|
ui/ |
3,932 | 78.3 MB |
stream/ |
40 | 30.5 MB |
config/ |
138 | 23.2 MB |
d6c1e95a/ (zamčený kód; jeho název se v každém vydání liší) |
7 | 5.5 MB |
data/ |
2 | 1.4 MB |
bridge/ |
55 | 0.5 MB |
guides/ |
13 | 0.2 MB |
phone.sql |
1 | 0.2 MB |
fxmanifest.lua |
1 | 6 KB |
celá složka phone |
4,204 | 139.7 MB |
Aktualizujete stávající instalaci? Nejdřív postupujte podle Aktualizace, abyste zachovali nastavení a média hráčů. Před přechodem na Pulse zastavte předchozí telefonní resource.
3. Přidejte předměty do inventáře
Otevřete Inventáře a postupujte podle pokynů pro inventář, který už používáte. Dodané definice a obrázky jsou v config/items/. Záznamy do inventáře slučte; nenahrazujte celý jeho soubor s předměty.
Výchozí inventář ESX a QBCore umí chybějící definice zaregistrovat automaticky. Jiné inventáře mohou vyžadovat dodané záznamy. Obrázky předmětů zkopírujte tam, kde je váš inventář očekává. Standalone bez inventáře žádné předměty nepotřebuje.
4. Spusťte Pulse
V config/config.lua ponechte automatické rozpoznávání. První sekce obsahuje framework, jazyk, výběr inventáře, předmět telefonu a klávesy. Volitelná nastavení jsou rozepsaná v Konfiguraci.
Přidejte toto za své stávající závislosti v server.cfg:
ensure phone
add_ace group.admin phone.admin allowRestartujte server. Pulse vytvoří své databázové tabulky, jakmile je dostupné SQL připojení. Přečtěte si jeho kontrolu v konzoli a proveďte případné opravy, které navrhne. Příkazem phone:health ji zopakujete.
5. Otevřete telefon
Připojte se jako administrátor, otevřete F8 a zadejte phone:setup. Potvrďte rozpoznaný framework a inventář a dokončete průvodce nastavením. Telefon otevřete klávesou F1 nebo příkazem /phone. Pokud vaše nastavení vyžaduje předmět, kupte nejdřív telefon a použijte jeho krabici z inventáře.
Nastavení uložená v Settings → Server přepisují odpovídající nastavení ze souborů. Pokud chcete, aby znovu platila hodnota ze souboru, resetujte tam uložený přepis.
6. Volitelné: odlehčený screenshot-basic
Váš download obsahuje také složku screenshot-basic. Je to screenshot-basic od CitizenFX (licence MIT) s jednou změnou: originál každý snímek znovu vykresluje obraz hry pro svou vrstvu zachycení, i když nikdo nefotí, a tato kopie kreslí jen během pořizování fotky. Název resource, jeho exporty (requestScreenshot, requestScreenshotUpload, requestClientScreenshot) i eventy jsou beze změny a přichází už sestavený, takže se při prvním startu nemusí sestavovat. Změněné soubory jsou uvedené v screenshot-basic/ZERODEV-CHANGES.md.
Pulse funguje s kteroukoli kopií, takže tento krok je volitelný. Screenshot-basic používají i jiné scripty na vašem serveru, takže pokud máte testovací server, přepněte nejdřív tam:
- Přejmenujte svou současnou složku
screenshot-basic(například nascreenshot-basic.bak) a přesuňte ji mimoresources, abyste ji mohli vrátit. - Zkopírujte naši do
resourcespod stejným názvem,screenshot-basic, a ponechte stejný řádekensure screenshot-basic. - Restartujte server a vyzkoušejte každý script, který pořizuje snímky obrazovky: fotoaparát telefonu a jakýkoli nástroj na reporty, důkazy nebo bodycam, který používáte.
- Pokud se cokoli chová jinak, smažte naši kopii, vraťte svou starou složku jako
screenshot-basica restartujte.
Nastavte funkce, které používáte
- Hovory, video a Live: podporované voice resources, ovládání hovorů a nastavení video připojení pro produkci.
- Fotky a videa: vestavěné úložiště, FiveManage a další možnosti nahrávání. Soukromé klíče služeb zůstávají v konfiguraci serveru. Na hostovaném serveru, jehož webový port není dostupný, potřebují fotky FiveManage: dva řádky v
server.cfg(set phone_media_provider "fivemanage"aset phone_fivemanage_token "<token>"). - Konfigurace: obchody, aplikace, příslušenství, jazyky a volitelné funkce.
- Řešení problémů: najděte příznak a postupujte podle řešení.
- Integrace pro vývojáře: vlastní scripty a pokročilá nastavení připojení.
Běžná instalace nevyžaduje úpravy bridge/, ui/ ani stream/. Ponechte celý resource pohromadě, včetně jeho modelů a map assetů.