Histórias de CS

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

É um recurso autônomo 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.

Pronto para uso, fornecemos ganchos para gcphone, qb-phone, high-phone e qs-smartphone que abrangem esses telefones e também versões tradicionais que são baseadas neles, como gksfone e xenknight. O ganchos pode ser ajustado conforme sua preferência para alterações de elementos ou estilo.

Se você é um desenvolvedor de telefones e um gancho cobre seu telefone, mas você não quer que isso aconteça, ou se você quer que façamos um gancho que cubra seu telefone, entre em contato conosco.

As histórias são mostradas temporariamente (padrão 24 horas) no feed de histórias. Esse valor pode ser alterado na configuração junto com o tempo para manter as histórias no armazenamento (padrão 24 horas). O comprimento máximo padrão de uma história é 30 segundos (o que resulta em ~5 MB por vídeo de história de comprimento máximo, excluindo a miniatura). Esse 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 você quiser postar as histórias do jogo no seu servidor Discord para fins de moderação e/ou registro, você pode baixar o recurso complementar histórias-cs-dw para fazer isso. Verifique seu configuração.js para obter mais informações e certifique-se de usá-lo de acordo com as políticas de webhook do Discord.

Um servidor de hospedagem está incluído obrigatório, com fio recurso necessário como dependência. O servidor de hospedagem armazena os vídeos das histórias, miniaturas e alguns metadados, portanto, impõe requisitos de rede, largura de banda e armazenamento assim como exigindo que uma porta TCP extra seja aberta. Além da solução integrada, o servidor de hospedagem também é oferecido como um servidor externo nó.js aplicação a ser hospedada na mesma máquina ou em uma máquina diferente permitindo que você compense os requisitos de rede, largura de banda e 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. Como alternativa, você pode alterar o versão_fx do seu telefone para “ousado”.

Características

• Histórias em vídeo curtas e temporárias apresentando o local e o nome do remetente no jogo.
• Capacidade de autoexclusão de histórias enviadas e integração para jogadores autorizados excluírem histórias de qualquer pessoa.
• Histórias simplistas alimentadas com navegação completa por mouse e teclado apoiar.
• Capacidade de alternar entre a câmera traseira e a 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 cor (escala de cinza, sépia, inverter, saturar, etc.).
• Filtros de imagem com rastreamento facial de pedófilos 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. Certifique-se de ter fio em seu recursos pasta.
2. Download histórias cs e coloque-o em seu recursos pasta.
3. Adicionar garantir cs-stories para o arquivo de configuração do seu servidor antes de garantir seu telefone.
4. Edite o seu telefone __recurso.lua ou fxmanifest.lua arquivar e adicionar ‘@cs-stories/client/hooks/core.lua' como o último script do cliente e ‘@cs-stories/servidor/ganchos/core.lua' como o último script do servidor.
5. Edite o arquivo NUI do seu telefone (geralmente índice.html) e adicione <script type=”text/javascript” src=”nui://cs-stories/client/hooks/core.js”></script> logo antes </body>.
6. Verifique o configuração.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. Considerando que você está usando a solução interna, abra o porta necessária (por padrão 35540; entrada – entrada) no seu firewall em TCP protocolo.
8. Execute o comando atualizar e o comando garantir cs-stories.
9. Se o seu telefone usa um loop de animação, talvez seja 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 de videochamada for aberta.
10. Garanta seu telefone.

Servidor de hospedagem externo

Se você optar por não usar o servidor proxy integrado então baixar o externo nó.js aplicativo e instale-o com instalação npm, leia todas as opções e seus comentários dentro dela configuração.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ó, então certifique-se de adicionar o endereço IP do servidor externo no 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

• O jogador será solicitado a aprovar o microfone, se negar, sua voz não será gravada nas histórias. Se negar por engano, precisará redefini-lo (por enquanto, isso é feito excluindo o arquivo “%AppData%CitizenFXmedia_access.json”).
• Ao gravar uma história, a voz é gravada pelo microfone padrão do sistema do jogador. Isso não pode ser alterado.
• Apenas a voz do player que grava é gravada. Isso não pode ser alterado.
• A gravação determina se o jogador 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 gravando uma história não pode se mover. Esse é o comportamento padrão da câmera do GTA:V. Você pode tentar usar o modo de câmera experimental que permite que o jogador se mova, no entanto, pode não ser tão suave quanto o nativo.
• Atrasos ou travamentos na renderização do 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), o que quer que esteja no jogo é gravado. Isso inclui configurações visuais/mods, desenhos do jogo/UIs, mas não NUIs.
• Se o seu servidor estiver sendo executado por trás de um proxy reverso sobre o qual você não tem controle e não pode 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, um VPS barato com largura de banda/rede/armazenamento suficientes para trabalhar dentro dos seus próprios limites) que possa lidar com os requisitos.
• Quando uma história está sendo carregada ou visualizada por um player, como qualquer outro serviço de upload de vídeo, a velocidade de upload/download do player está sendo usada e a rede/largura de banda também é consumida no servidor de hospedagem.
• Se o seu servidor de hospedagem host não oferece largura de banda ilimitada ou tem um limite de rede baixo, é aconselhável que você verifique periodicamente suas estatísticas de uso se tiver muitos jogadores carregando e visualizando histórias. Também certifique-se de verificar seu armazenamento se tiver uma tonelada de histórias sendo carregadas e não estiverem sendo limpas.
• O recurso está usando Armazenamento KV da FiveM para armazenar os metadados das histórias salvas, se você estiver usando uma configuração de vários servidores compartilhada, 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 no jogo sejam legítimos e venham do próprio jogo. No entanto, como o cliente os envia, eles não são 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 enviar uma história, ocorre um erro. Por quê?
UM: 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. Como alternativa, você pode alterar o versão_fx do seu telefone para “ousado”. Se esse não era o seu problema, então o problema geralmente está em TCP bloqueando, configuração de rede complexa ou proteção anti-DDoS. Experimente uma porta diferente, de preferência em uma 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, sua melhor solução 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 suficientes para trabalhar dentro dos seus próprios limites) que possa atender aos requisitos.

P: Fiz tudo, mas não consigo ver o botão do aplicativo Stories. O que há de errado?
UM: Não ver um botão do aplicativo de histórias possivelmente está relacionado ao hook que você está usando. Primeiro, certifique-se de que está usando o hook correto para o telefone que você tem. Em seguida, certifique-se de que os eventos do seu telefone e os elementos DOM estão refletidos corretamente no hook e que o hook está configurado corretamente. Observe também que alguns hooks 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 devo fazer?
UM: 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á.