Documentação do Pulse Phone
Pulse Phone — Guia rápido
Instale um único resource chamado phone. Mantenha o seu framework e os scripts suportados que já tem; o Pulse deteta-os quando arranca.
O PhoneHub + Pulse é uma edição separada, com licença própria e a sua própria cópia deste telemóvel. Se comprou essa edição, siga antes o guia de instalação dela: um servidor corre um único resource de telemóvel.
1. Verifique o seu servidor
| O quê | É preciso? |
|---|---|
| OneSync ativo, game build 2699 ou mais recente | Obrigatório |
| Uma base de dados: oxmysql (ou mysql-async, ghmattimysql) em MariaDB 10.6+ ou MySQL 8 | Recomendado. Sem um resource SQL, o telemóvel guarda os dados no armazenamento chave/valor do servidor |
| Um resource de voz: pma-voice, mumble-voip, SaltyChat, TokoVOIP ou YACA | Recomendado. Sem nenhum, as chamadas ligam mas não têm áudio |
| screenshot-basic | Recomendado, para a câmara poder guardar fotos. O resource padrão funciona |
| Um framework e um inventário | Opcional. Sem eles, o telemóvel funciona em standalone |
Inicie a base de dados, o framework, o inventário, o resource de voz e o screenshot-basic antes do Pulse. Veja os requisitos e o seu framework para a ordem correta.
Faça uma cópia de segurança da base de dados antes do primeiro arranque. O Pulse cria as suas próprias tabelas. Se outro telemóvel deixou tabelas com os mesmos nomes, são renomeadas para old_<name> (nada é apagado); os pormenores estão nos requisitos.
2. Copie a pasta phone
Transfira a sua compra a partir da sua conta Cfx.re. Copie a pasta phone que contém o fxmanifest.lua para os resources do seu servidor. Mantenha o nome. A chave do seu servidor tem de pertencer à conta que é dona do asset.
Envio por FTP (servidor alojado): use o modo Binary (FileZilla: Transfer > Transfer Type > Binary), ou envie o zip e extraia-o no servidor. O modo Auto altera os ficheiros protegidos e o telemóvel recusa-se a arrancar; os sintomas e a solução estão em Resolução de problemas. A pasta que envia tem de corresponder a esta tabela; a verificação de arranque indica qualquer ficheiro em falta ou com o tamanho errado.
A transferência do Pulse Phone 1.4.2:
| Pasta ou ficheiro | Ficheiros | Tamanho |
|---|---|---|
ui/ |
3,932 | 78,3 MB |
stream/ |
40 | 30,5 MB |
config/ |
138 | 23.2 MB |
d6c1e95a/ (o código bloqueado; o nome muda em cada versão) |
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 |
pasta phone completa |
4,204 | 139.7 MB |
Vai atualizar uma instalação existente? Siga primeiro Atualizar para manter as definições e os conteúdos multimédia dos jogadores. Pare o resource de telemóvel anterior antes de mudar para o Pulse.
3. Adicione os itens ao inventário
Abra Inventários e siga as instruções para o inventário que já usa. As definições e imagens fornecidas estão em config/items/. Junte as entradas ao seu inventário; não substitua o ficheiro de itens inteiro.
O inventário padrão do ESX e o QBCore podem registar automaticamente as definições em falta. Outros inventários podem precisar das entradas fornecidas. Copie as imagens dos itens para onde o seu inventário as espera. Em standalone sem inventário, não são precisos itens.
4. Inicie o Pulse
Mantenha a deteção automática em config/config.lua. A primeira secção contém o framework, o idioma, a escolha do inventário, o item do telemóvel e as teclas. As definições opcionais estão indexadas em Configuração.
Adicione isto depois das dependências que já tem no server.cfg:
ensure phone
add_ace group.admin phone.admin allowReinicie o servidor. O Pulse cria as suas tabelas na base de dados quando a ligação SQL está disponível. Leia a verificação na consola e siga as instruções de correção que houver. Corra phone:health para a repetir.
5. Abra o seu telemóvel
Entre como administrador, abra o F8 e escreva phone:setup. Confirme o framework e o inventário detetados e conclua a configuração guiada. Carregue em F1 ou use /phone para abrir o telemóvel. Se as suas definições exigirem um item, compre primeiro um telemóvel e use a caixa a partir do inventário.
As definições guardadas em Settings → Server sobrepõem-se às definições equivalentes dos ficheiros. Reponha aí uma definição guardada se quiser que o valor do ficheiro volte a valer.
6. Opcional: o screenshot-basic mais leve
A sua transferência também contém uma pasta screenshot-basic. É o screenshot-basic da CitizenFX (licença MIT) com uma alteração: o original volta a desenhar a imagem do jogo para a sua camada de captura em cada frame, mesmo quando ninguém está a tirar uma foto, e esta cópia só desenha enquanto uma foto está a ser tirada. O nome do resource, os seus exports (requestScreenshot, requestScreenshotUpload, requestClientScreenshot) e os seus eventos não mudaram, e já vem compilado, por isso não precisa de se compilar no primeiro arranque. Os ficheiros alterados estão listados em screenshot-basic/ZERODEV-CHANGES.md.
O Pulse funciona com qualquer uma das cópias, por isso este passo é opcional. Outros scripts do seu servidor também usam o screenshot-basic, por isso faça a troca primeiro num servidor de testes, se tiver um:
- Mude o nome da sua pasta
screenshot-basicatual (por exemplo parascreenshot-basic.bak) e tire-a deresources, para a poder repor. - Copie a nossa para
resourcescom o mesmo nome,screenshot-basic, e mantenha a mesma linhaensure screenshot-basic. - Reinicie o servidor e experimente todos os scripts que tiram capturas de ecrã: a câmara do telemóvel e qualquer ferramenta de denúncias, provas ou bodycam que use.
- Se algo se comportar de forma diferente, apague a nossa cópia, reponha a sua pasta antiga como
screenshot-basice reinicie.
Configure as funcionalidades que usa
- Chamadas, vídeo e Live: resources de voz suportados, controlos de chamada e configuração da ligação de vídeo em produção.
- Fotos e vídeos: armazenamento incluído, FiveManage e outras opções de envio. As chaves privadas de serviços ficam na configuração do seu servidor. Num servidor alojado cuja porta web não esteja acessível, as fotos precisam do FiveManage: duas linhas no
server.cfg(set phone_media_provider "fivemanage"eset phone_fivemanage_token "<token>"). - Configuração: lojas, apps, acessórios, idiomas e funcionalidades opcionais.
- Resolução de problemas: encontre o sintoma e siga a solução.
- Integrações para programadores: scripts personalizados e definições de ligação avançadas.
Uma instalação normal não exige editar bridge/, ui/ nem stream/. Mantenha o resource completo junto, incluindo os modelos e os assets de mapa.