1# ArrayBuffer对象 2<!--Kit: ArkTS--> 3<!--Subsystem: CommonLibrary--> 4<!--Owner: @wang_zhaoyong--> 5<!--Designer: @weng-changcheng--> 6<!--Tester: @kirl75; @zsw_zhushiwei--> 7<!--Adviser: @ge-yafang--> 8 9ArrayBuffer包含两部分：底层存储数据的Native内存区域，以及封装操作的JS对象壳。JS对象壳分配在虚拟机的本地堆（LocalHeap）中。跨线程传递时，JS对象壳需要序列化和反序列化拷贝传递，而Native内存区域可以通过拷贝或转移的方式传递。 10 11Native内存使用拷贝方式（递归遍历）传输时，传输后两个线程可以独立访问ArrayBuffer。此方式需要重建JS壳和拷贝Native内存，传输效率较低。通信过程如下图所示： 12 13 14 15Native内存使用转移方式传输时，传输后原线程将无法使用此ArrayBuffer对象。跨线程时只需重建JS壳，Native内存无需拷贝，从而提高效率。通信过程如下图所示 16 17 18 19ArrayBuffer可以用来表示图片等资源，在应用开发中，处理图片（如调整亮度、饱和度、大小等）会比较耗时，为了避免长时间阻塞UI主线程，可以将图片传递到子线程中进行处理。采用转移方式传递ArrayBuffer可提高传输性能，但原线程将无法再访问该ArrayBuffer对象。如果两个线程都需要访问该对象，只能采用拷贝方式。反之，建议采用转移方式以提升性能。 20 21以下将通过具体的代码案例分别介绍拷贝和转移两种方式，实现图片跨ArkTS线程传输。 22 23## ArrayBuffer拷贝传输方式 24 25在ArkTS中，TaskPool传递ArrayBuffer数据时，默认采用转移方式。通过调用setTransferList()接口，可以指定部分数据的传递方式为转移方式，其他部分数据可以切换为拷贝方式。 26 27首先，实现一个处理ArrayBuffer的接口，该接口在Task中执行。 28 29然后，通过拷贝方式将ArrayBuffer数据传递到Task中，并进行处理。 30 31最后，UI主线程接收到Task执行完毕后返回的ArrayBuffer数据，进行拼接并展示。 32 33```ts 34// Index.ets 35import { taskpool } from '@kit.ArkTS'; 36import { BusinessError } from '@kit.BasicServicesKit'; 37 38@Concurrent 39function adjustImageValue(arrayBuffer: ArrayBuffer): ArrayBuffer { 40 // 对arrayBuffer进行操作，返回值默认转移 41 return arrayBuffer; 42} 43 44function createImageTask(arrayBuffer: ArrayBuffer, isParamsByTransfer: boolean): taskpool.Task { 45 let task: taskpool.Task = new taskpool.Task(adjustImageValue, arrayBuffer); 46 // 是否使用转移方式 47 if (!isParamsByTransfer) { 48 // 传递空数组[]，全部arrayBuffer参数传递均采用拷贝方式 49 task.setTransferList([]); 50 } 51 return task; 52} 53 54@Entry 55@Component 56struct Index { 57 @State message: string = 'Hello World'; 58 59 build() { 60 RelativeContainer() { 61 Text(this.message) 62 .id('HelloWorld') 63 .fontSize(50) 64 .fontWeight(FontWeight.Bold) 65 .alignRules({ 66 center: { anchor: '__container__', align: VerticalAlign.Center }, 67 middle: { anchor: '__container__', align: HorizontalAlign.Center } 68 }) 69 .onClick(() => { 70 let taskNum = 4; 71 let arrayBuffer = new ArrayBuffer(1024 * 1024); 72 let taskPoolGroup = new taskpool.TaskGroup(); 73 // 创建taskNum个Task 74 for (let i: number = 0; i < taskNum; i++) { 75 let arrayBufferSlice: ArrayBuffer = arrayBuffer.slice(arrayBuffer.byteLength / taskNum * i, arrayBuffer.byteLength / taskNum * (i + 1)); 76 // 使用拷贝方式传入ArrayBuffer，所以isParamsByTransfer为false 77 taskPoolGroup.addTask(createImageTask(arrayBufferSlice, false)); 78 } 79 // 执行Task 80 taskpool.execute(taskPoolGroup).then((data) => { 81 // 返回结果，对数组拼接，获得最终结果 82 }).catch((e: BusinessError) => { 83 console.error(e.message); 84 }) 85 }) 86 } 87 .height('100%') 88 .width('100%') 89 } 90} 91``` 92<!-- @[copy_arraybuffer_transfer](https://gitcode.com/openharmony/applications_app_samples/blob/master/code/DocsSample/ArkTS/ArkTsConcurrent/ConcurrentThreadCommunication/InterThreadCommunicationObjects/CommunicationObjects/entry/src/main/ets/managers/ArrayBufferObject.ets) --> 93 94## ArrayBuffer转移传输方式 95 96在TaskPool中，传递ArrayBuffer数据时，默认使用转移方式，原线程将无法再使用已传输给子线程的ArrayBuffer。 在上文示例的基础上去除task.setTransferList接口调用，即在createImageTask的第二个参数传入true，就可以实现转移方式的传输。 97
