Histórias de CS

O recurso vem com um configuração extensa, eventos, exportações e alguns arquivos de origem cliente/servidor para permitir que você personalize ao seu gosto.

É um recurso independente e funciona com qualquer estrutura e pode ser conectado a qualquer telefone baseado em Lua NUI, desde que você possa desenvolver o gancho para ele.

Fora da caixa, fornecemos ganchos para gcphone, qb-phone, high-phone e qs-smartphone que cobrem esses telefones e também versões convencionais baseadas neles, como gksphone e Cavaleiro Xen. O ganchos pode ser ajustado ao seu gosto para alterações de elementos ou estilo.

Se você é um desenvolvedor de telefone e um gancho cobre seu telefone, mas você não quer, ou se deseja que façamos um gancho que cubra seu telefone, por favor Entre em contato conosco.

As histórias são mostradas temporariamente (padrão 24 horas) no feed de histórias. Este valor pode ser alterado na configuração junto com o tempo para manter as histórias armazenadas (padrão 24 horas). A duração máxima padrão de uma história é de 30 segundos (o que resulta em aproximadamente 5 MB por vídeo de história com duração máxima, excluindo a miniatura). Este valor pode ser alterado na configuração e também há um limite de taxa configurável para garantir que seu servidor não fique sem armazenamento.

Se quiser postar as histórias do jogo em seu servidor Discord para moderação e/ou fins de registro, você pode baixar o recurso complementar cs-histórias-dw para fazer isso. Verifique seu config.js para obter mais informações e certifique-se de usá-lo de acordo com as políticas de webhook do Discord.

Está incluído um servidor de hospedagem que é obrigatório, com fio recurso necessário como uma dependência. O servidor de hospedagem armazena os vídeos, miniaturas e alguns metadados das histórias, por isso impõe requisitos de rede, largura de banda e armazenamento assim como exigindo que uma porta TCP extra esteja aberta. Além da solução integrada, o servidor de hospedagem também é oferecido como externo nó.js aplicativo a ser hospedado na mesma máquina ou em uma máquina diferente permitindo compensar os requisitos de rede, largura de banda ou armazenamento.

Se o seu telefone for de versão_fx “cerúleo”, então você terá que rotear o servidor de hospedagem das histórias via HTTPS. Você pode fazer isso usando um domínio e Cloudflare. Alternativamente, você pode alterar o versão_fx do seu telefone para “corajoso”.

Recursos

• Histórias de vídeo curtas e temporárias apresentando a localização e o nome do remetente no jogo.
• Capacidade de autoexcluir histórias carregadas e integração para jogadores autorizados excluirem histórias de qualquer pessoa.
• Feed de histórias simplista com suporte completo para navegação por mouse e teclado.
• Capacidade de alternar entre a câmera traseira e frontal.
• Ajuste dinâmico para centralizar corretamente em várias resoluções.
• Integração plug-and-play com telefones para os quais oferecemos ganchos prontos para uso.
• Filtros de cores (tons de cinza, sépia, inverter, saturar, etc.).
• Filtros de imagem com rastreamento facial do jogador em tempo real (cachorro, gato, etc.).
• Otimizado para um equilíbrio entre qualidade e desempenho.
• Um modo de câmera experimental que permite ao jogador se mover enquanto grava uma história.
• Uma ampla gama de eventos e exportações para verificar e controlar o recurso.

instruções de instalação

1. Assegure-se de ter fio em seu recursos pasta.
2. Baixar histórias cs e coloque-o em seu recursos pasta.
3. Adicionar garantir histórias cs ao arquivo de configuração do seu servidor antes de garantir o seu telefone.
4. Edite o seu telefone __resource.lua ou fxmanifest.lua arquivo e adicione ‘@cs-stories/client/hooks/core.lua' como o último script do cliente e ‘@cs-stories/server/hooks/core.lua' como o último script do servidor.
5. Edite o arquivo NUI do seu telefone (geralmente index.html) e adicione <script type=”text/javascript” src=”nui://cs-stories/client/hooks/core.js”></script> logo antes </body>.
6. Verifica a config.lua arquivo dentro histórias cs para configuração adicional e leia todas as opções e seus comentários e ajuste-os de acordo com sua configuração e preferências.
7. Dado que você está usando a solução interna, abra o porta necessária (por padrão 35540; entrada – entrada) em seu firewall ativado TCP protocolo.
8. Execute o comando atualizar e o comando garantir histórias cs.
9. Se o seu telefone usa um loop de animação, pode ser necessário editá-lo (geralmente encontrado em um animação.lua arquivo) e adicione um não CS_STORIES.ACTIVE verifique antes de reproduzir uma animação para garantir que não ocorra uma falha na animação quando a câmera da videochamada for aberta.
10. Garanta seu telefone.

Servidor de hospedagem externo

Se optar por não utilizar o servidor proxy integrado então baixe o externo nó.js aplicativo e instale-o com instalação npm, leia todas as opções e seus comentários dentro de seu config.js arquivo pois são muito importantes para o processo de configuração, ajuste-os de acordo com sua configuração e preferências e então execute-o com nóe certifique-se de adicionar o endereço IP do servidor externo no campo sv_proxyIPRanges propriedade no arquivo de configuração do seu servidor. Você pode usar pm2 para garantir que ele funcione o tempo todo.

Informações importantes

• Será solicitada a aprovação do microfone ao jogador, caso ele negue sua voz não será gravada nos stories. Se negarem por engano, precisarão redefini-lo (por enquanto isso é feito excluindo o arquivo “%AppData%\CitizenFX\media_access.json”).
• Ao gravar uma história, a voz é gravada pelo microfone padrão do sistema do jogador. Isto não pode ser alterado.
• Apenas a voz da gravação do player é gravada. Isto não pode ser alterado.
• A gravação determina se o player está falando usando o nativo integrado. Se você estiver usando um VoIP externo, como TokoVoip ou similar, você precisará editar o gancho para determinar corretamente quando o jogador está falando.
• Um jogador que grava uma história não pode se mover. Este é o comportamento padrão da câmera GTA:V. Você pode tentar usar o modo de câmera experimental que permite ao jogador se mover, mas pode não ser tão suave quanto o nativo.
• Atrasos/congelamentos na renderização de vídeo podem ser causados em resoluções muito altas ou em sistemas com especificações muito baixas.
• A gravação da história funciona usando captura de jogo (semelhante a captura de tela básica), tudo o que estiver no jogo será gravado. Isso inclui configurações/mods visuais, desenhos de jogos/UIs, mas não NUIs.
• Se o seu servidor estiver rodando atrás de um proxy reverso sobre o qual você não tem controle e não puder lidar com uma porta TCP extra conforme exigido pelo recurso, sua única opção pode ser hospedar externamente o servidor de hospedagem das histórias em uma máquina diferente (por exemplo, uma máquina barata VPS com largura de banda/rede/armazenamento suficiente para funcionar dentro de seus próprios limites) que pode atender aos requisitos.
• Quando uma história é carregada ou visualizada por um jogador, como qualquer outro serviço de upload de vídeo, a velocidade de upload/download do jogador está sendo usada e a rede/largura de banda também é consumida no servidor de hospedagem.
• Se o host do seu servidor de hospedagem não oferece largura de banda ilimitada ou tem um limite de rede baixo, é aconselhável verificar periodicamente suas estatísticas de uso se houver muitos jogadores enviando e visualizando histórias. Certifique-se também de verificar seu armazenamento se você tiver muitas histórias sendo carregadas e não estiverem sendo limpas.
• O recurso está usando o armazenamento KV do FiveM para armazenar os metadados das histórias salvas. Se você estiver usando uma configuração compartilhada de vários servidores, isso pode causar um problema e você pode querer definir sv_kvsNome variável de console para algo exclusivo para seu servidor.
• Existem verificações para garantir que o vídeo gravado e a localização do jogo são legítimos e vêm do próprio jogo; no entanto, como o cliente os envia, eles não podem ser totalmente confiáveis.
• As histórias são excluídas (conforme configuração) quando o recurso é iniciado, portanto, a limpeza do armazenamento de histórias depende da frequência com que você reinicia o servidor ou o recurso.

Problemas e perguntas frequentes

P: Posso usar o aplicativo de histórias, mas quando tento visualizar ou fazer upload de uma história ocorre um erro, por quê?
A: Se o seu telefone for de versão_fx “cerúleo”, então você terá que rotear o servidor de hospedagem das histórias via HTTPS. Você pode fazer isso usando um domínio e Cloudflare. Alternativamente, você pode alterar o versão_fx do seu telefone para “corajoso”. Se esse não for o seu problema, o problema geralmente está em TCP bloqueando, configuração de rede complexa ou anti-Proteção DDoS. Experimente uma porta diferente, de preferência numa faixa alta para ver se isso resolverá seu problema e certifique-se de que a porta esteja aberta para o protocolo TCP. Se isso não funcionar, então sua melhor solução aqui pode ser hospedar externamente o servidor de hospedagem das histórias em uma máquina diferente (por exemplo, um VPS barato com largura de banda/rede/armazenamento suficiente para funcionar dentro de seus próprios limites) que possa lidar com os requisitos .

P: Já fiz tudo, mas não consigo ver o botão do aplicativo Stories, o que há de errado?
A: Não ver o botão do aplicativo Stories possivelmente está relacionado ao gancho que você está usando. Primeiro, certifique-se de usar o gancho correto para o telefone que você possui. Em seguida, certifique-se de que os eventos do telefone e os elementos DOM estejam refletidos corretamente no gancho e que o gancho esteja configurado corretamente. Observe também que alguns ganchos adicionam o aplicativo de histórias na loja de aplicativos do telefone, em vez de adicioná-lo imediatamente como um aplicativo.

P: Meu fio está tentando instalar o recurso repetidamente, o que eu faço?
A: Este parece ser um bug atual no fio recurso relacionado a pacote.json e o fuso horário do servidor relacionado ao fuso horário do sistema do qual você copiou o recurso. Editar pacote.json e basta adicionar ou remover um caractere de espaço, salvá-lo e o problema desaparecerá.