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.

Para o Pulse Phone 1.4.24 min de leituraAtualizado a

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:

server.cfg
ensure phone
add_ace group.admin phone.admin allow

Reinicie 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:

  1. Mude o nome da sua pasta screenshot-basic atual (por exemplo para screenshot-basic.bak) e tire-a de resources, para a poder repor.
  2. Copie a nossa para resources com o mesmo nome, screenshot-basic, e mantenha a mesma linha ensure screenshot-basic.
  3. 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.
  4. Se algo se comportar de forma diferente, apague a nossa cópia, reponha a sua pasta antiga como screenshot-basic e 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" e set 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.

Traduzido do inglês. Se alguma coisa aqui não coincidir com a página em inglês, vale a página em inglês. English