• ByteArray 扩展
  • 下载和安装
    • 扩展下载
  • 功能概述
    • 属性
    • 方法
    • 事件
  • 使用示例
    • 基本用法
    • 读写整数
    • 字符串处理
    • 文件操作
    • 字节序转换
  • 常见应用场景
    • 1. 网络通信
    • 2. 文件格式处理
    • 3. 数据加密
    • 4. 传感器数据处理
    • 5. 协议实现
  • 注意事项
  • 相关资源

« 返回IoT首页

ByteArray 扩展

ByteArray扩展为App Inventor提供了强大的字节数组处理功能，支持各种字节数据操作和转换。

下载和安装

扩展下载

• ByteArray扩展: UrsAI2ByteArray.zip
• 示例项目: ByteArrayTest.aia

功能概述

ByteArray扩展提供了以下主要功能：

• 字节数组的创建和管理
• 各种数据类型的读写操作
• 字节序控制（大端序/小端序）
• 十六进制转换
• 文件读写操作
• 错误处理机制

属性

可用字节数

返回还可以顺序读取的字节数。只读属性。

基址索引

获取或设置第一个项目的索引。可能值为1（App Inventor常规值）或0（Java/C常规值），默认值为1。

字节序

获取或设置字节序，决定多字节数据的存储顺序。可选值为”BigEndian”（大端序）或”LittleEndian”（小端序），默认为”BigEndian”。

十六进制前缀

获取或设置十六进制表示的前缀字符串，默认为”0x”。

数组长度

返回字节数组的总长度。只读属性。

高位在前

设置字节序，决定多字节数据的存储顺序。true为大端序（网络字节序），false为小端序（x86架构），默认为true。

当前位置

获取或设置当前读/写位置。

大小

返回字节数组的大小。只读属性。

方法

添加字节(字节值)

将一个字节添加到字节数组的末尾。如果值超出范围（<0或>255），触发ErrorOccurred事件（错误号17200）。

添加16位整数(整数值)

将一个16位整数添加到字节数组中。

添加32位整数(整数值)

将一个32位整数添加到字节数组中。

添加64位整数(整数值)

将一个64位整数添加到字节数组中。

添加单精度浮点数(浮点数值)

将一个单精度浮点数添加到字节数组中。

添加字符串(字符串)

将字符串转换为字节并添加到字节数组中。

清空()

清空字节数组中的所有数据。

获取字节(索引)

获取指定位置的字节值。

获取字节数组(起始位置,长度)

获取指定范围的字节数组。

获取16位整数(索引)

从指定位置读取16位整数。

获取32位整数(索引)

从指定位置读取32位整数。

获取64位整数(索引)

从指定位置读取64位整数。

获取单精度浮点数(索引)

从指定位置读取单精度浮点数。

获取字符串(起始位置,长度)

从指定位置读取指定长度的字符串。

查找字节(字节值)

查找指定字节值在数组中的位置。

插入字节(索引,字节值)

在指定位置插入一个字节。

移除指定位置(索引)

移除指定位置的字节。

设置字节(索引,字节值)

设置指定位置的字节值。

转十六进制(数值,位数)

将无符号数字转换为十六进制表示。如果位数无效或值超出范围，返回”-“。

转字符串()

将整个字节数组转换为字符串表示。

事件

文件写入完成时(文件名,文件路径)

文件写入操作完成时触发。参数包括文件名和文件的绝对路径。

出现错误时(函数名称,错误编号,消息)

发生错误时触发该事件。提供错误相关的详细信息。

使用示例

基本用法

when Button1.Click
do
    // 创建字节数组并添加数据
    call ByteArray1.Clear
    call ByteArray1.AddByte 65    // 添加字符 'A'
    call ByteArray1.AddByte 66    // 添加字符 'B'
    call ByteArray1.AddByte 67    // 添加字符 'C'

    // 获取数组长度
    set Label1.Text to "数组长度: " & ByteArray1.Size

    // 转换为十六进制字符串
    set Label2.Text to "十六进制: " & ByteArray1.ToString

读写整数

when Button2.Click
do
    // 添加不同类型的整数
    call ByteArray1.Clear
    call ByteArray1.AddInt16 12345
    call ByteArray1.AddInt32 1234567890
    call ByteArray1.AddSingle 3.14159

    // 读取数据
    set Position to 0
    set Int16Value to ByteArray1.GetInt16(Position)
    set Position to Position + 2
    set Int32Value to ByteArray1.GetInt32(Position)
    set Position to Position + 4
    set FloatValue to ByteArray1.GetSingle(Position)

    set Label3.Text to "Int16: " & Int16Value & ", Int32: " & Int32Value & ", Float: " & FloatValue

字符串处理

when Button3.Click
do
    // 添加字符串
    call ByteArray1.Clear
    call ByteArray1.AddString "Hello World"

    // 读取字符串
    set StringValue to ByteArray1.GetString(0, ByteArray1.Size)

    set Label4.Text to "字符串: " & StringValue

文件操作

when Button4.Click
do
    // 将字节数组写入文件
    call ByteArray1.Clear
    call ByteArray1.AddString "这是要保存到文件的内容"

    // 注意：这里需要使用文件组件来实际保存数据
    call File1.Write ByteArray1.ToString

字节序转换

when Button5.Click
do
    // 设置字节序
    set ByteArray1.MsbFirst to true   // 大端序
    call ByteArray1.AddInt32 123456789

    set ByteArray1.MsbFirst to false  // 小端序
    call ByteArray1.AddInt32 123456789

    // 比较不同字节序的结果
    set Label5.Text to "大端序和小端序的字节表示不同"

常见应用场景

1. 网络通信

处理网络协议中的二进制数据，如TCP/UDP数据包的解析和构造。

2. 文件格式处理

读写各种文件格式，如图片、音频、配置文件等。

3. 数据加密

实现简单的加密算法，对数据进行字节级别的操作。

4. 传感器数据处理

处理来自传感器的原始二进制数据。

5. 协议实现

实现各种通信协议，如Modbus、CAN总线等。

注意事项

1. 索引范围: 确保访问的索引在有效范围内（0到Size-1）
2. 字节序: 注意大端序和小端序的区别，在网络通信中尤其重要
3. 错误处理: 监听ErrorOccurred事件以处理可能的错误
4. 内存管理: 大量数据操作时注意内存使用
5. 数据类型: 确保读写操作使用相同的数据类型

相关资源

• App Inventor文档
• IoT组件参考
• 网络通信组件

本文档基于UrsAI2ByteArray扩展官方文档整理，更多信息请访问ullisroboterseite.de。