uPacketDivision

uPacketDivision

Il s'agit d'un plug-in natif qui divise des données données ( System.IntPtr ou tableau) en tailles spécifiées et les restaure quel que soit l'ordre de saisie. Il est destiné à des cas d'utilisation tels que l'envoi de données volumineuses via UDP.

Installer

• Forfait Unité
  • Téléchargez le dernier package .unity à partir de la page Release.
• URL Git (UPM)
  • Ajoutez https://github.com/hecomi/uPacketDivision.git#upm au gestionnaire de packages.
• Registre étendu (UPM)
  • Ajoutez un registre étendu à votre projet.
    • URL : https://registry.npmjs.com
    • Portée : com.hecomi
  • Installez uPacketDivision dans le gestionnaire de packages.

Plateformes

Actuellement, il est uniquement conçu pour Windows.

Comment utiliser

Diviser

Créez un Divider et appelez Divide<T>(T[]) avec le tableau en entrée (ou Divide(System.IntPtr, int size) ). Cela divisera le paquet en interne.

 Divider divider = new Divider ( ) ;

void Divide ( )
{
    Texture2D image ;
    var pixels = image . GetPixels32 ( ) ;
    divider . maxPacketSize = packetSize ;
    divider . Divide ( pixels ) ;
}

Ensuite, envoyez les données fractionnées à la télécommande d'une manière ou d'une autre. Les fonctions suivantes sont disponibles.

• GetChunkCount() .
  • le nombre de morceaux.
• GetChunk()
  • Le tableau byte[] des données fractionnées
• GetChunkSize(int index) .
  • La taille des données fractionnées.
• GetChunkData(int index) .
  • Le pointeur des données fractionnées Voici un exemple d'utilisation d'uOSC.

 uOSC . uOscClient client ;

void Send ( int width , int height )
{
    client . Send ( "/Size" , width , height ) ;

    for ( uint i = 0 ; i < divider . GetChunkCount ( ) ; ++ i )
    {
        client . Send ( "/Data" , divider . GetChunk ( i ) ) ;
    }
}

Si vous souhaitez utiliser directement le pointeur et la taille, veuillez utiliser GetChunkSize() et GetChunkData() à la place.

Assembler

Utilisez Assembler pour assembler les données qui vous sont envoyées. Voici un exemple de la partie réceptrice utilisant uOSC.

 Assembler assembler = new Assembler ( ) ;
Texture2D texture ;

public void OnDataReceived ( uOSC . Message message )
{
    if ( message . address == "/Size" )
    {
        var w = ( int ) message . values [ 0 ] ;
        var h = ( int ) message . values [ 1 ] ;
        OnSize ( w , h ) ;
    }
    else if ( message . address == "/Data" )
    {
        var data = ( byte [ ] ) message . values [ 0 ] ;
        OnData ( data ) ;
        CheckEvent ( ) ;
    }
}

void OnSize ( int w , int h )
{
    texture = new Texture2D ( w , h ) ;
}

void OnData ( byte [ ] data )
{
    assembler . timeout = timeout ;
    assembler . Add ( data ) ;
}

Chaque fois que vous ajoutez des données, vérifiez l'achèvement ou la perte comme suit.

 void CheckEvent ( )
{
    switch ( assembler . GetEventType ( ) )
    {
        case EventType . FrameCompleted :
        {
            OnDataAssembled ( assembler . GetAssembledData < Color32 > ( ) ) ;
            break ;
        }
        case EventType . PacketLoss :
        {
            var type = assembler . GetLossType ( ) ;
            Debug . LogWarning ( "Loss: " + type ) ;
            break ;
        }
        default :
        {
            break ;
        }
    }
}

Si vous souhaitez obtenir un pointeur et sa taille au lieu d'un tableau, les API suivantes sont disponibles.

 var index = assembler . GetAssembledFrameIndex ( ) ;
var data = assembler . GetFrameData ( index ) ;
var size = assembler . GetFrameSize ( index ) ;
OnDataAssembled ( data , ( int ) size ) ;
assembler . RemoveFrame ( index ) ;

Ensuite, la reconstruction des données sera complétée comme suit.

 void OnDataAssembled ( Color32 [ ] pixels )
{
    texture . SetPixels32 ( pixels ) ;
    texture . Apply ( ) ;
    GetComponent < Renderer > ( ) . material . mainTexture = texture ;
}