Roku OS 15.0 中的高性能数据编排

Source: Dev.to

Source: …

MoveIntoField 和 MoveFromField

传统上，像 node.field = myAA 这样的赋值会执行深拷贝。在 Roku OS 15.0 中，MoveIntoField() 和 MoveFromField() 实际上是所有权的转移。数据会移动到节点中，而你的本地变量则变为空。

' --- BEFORE (The Blocking Copy) ---
' ...do some work
' m.top.content = hugeAA 
' 1. Task thread stops.
' 2. Render thread stops.
' 3. Both wait for a deep copy to finish. 
' 4. Breakpointing here kills the app because 
'    the Render thread is "stuck" waiting.

' --- AFTER (The Non-Blocking Move) ---
sub finishTask(hugeAA)
    ' ...do some work
    ' MoveIntoField transfers the memory pointer instantly.
    m.top.MoveIntoField("content", hugeAA)

    ' hugeAA is now empty. The Task can exit or move on without 
    ' holding a redundant copy in memory.
    ? "Task complete. hugeAA is now empty: " ; hugeAA.IsEmpty()
end sub

渲染线程引用：SetRef 与 GetRef

有时你并不想移动或复制数据——只想让渲染线程查看同一个对象实例。现在可以通过 Reference API 实现，这些 API 严格限制在渲染线程中使用。

• SetRef()：通过引用（不复制）为字段分配一个 AA。
• GetRef()：获取该引用以供使用。
• CanGetRef()：安全检查，判断引用是否存在。

注意： 使用 SetRef() 时字段观察者不会收到通知。这使其非常适合高频率数据（例如坐标跟踪），可以避免观察者通知带来的开销。

' --- BEFORE (Memory Inefficiency) ---
' m.childA.data = m.top.content ' Copy 1
' m.childB.data = m.top.content ' Copy 2 (Memory usage doubled)

' --- AFTER (Robust Reference Sharing) ---
' This must happen on the Render Thread (e.g., in an observer or queue handler)
sub shareTaskData()
    if m.top.CanGetRef("content")
        ref = m.top.GetRef("content")

        ' Pass the pointer to children. No deep copies are made.
        m.childA.SetRef("sharedContent", ref)
        m.childB.SetRef("sharedContent", ref)
    end if
end sub

roRenderThreadQueue

roRenderThreadQueue API 通过允许 Task 线程向 UI 线程发送数据而不触发 Rendezvous（会冻结 UI 的同步锁），解决了 “SceneGraph 漏洞”。可以把它想象成一个线程安全的邮箱：Task 线程投递消息后继续执行；Render 线程在帧之间处理这些消息。

核心 API

• roRenderThreadQueue – 管理节点。需要在 Render 线程（用于监听）和 Task 线程（用于发送）上都进行初始化。
• AddMessageHandler(message_id, handler_name) – 注册一个函数，当收到匹配 ID 的消息时执行。可以为同一个 ID 附加多个处理器，按注册顺序依次执行。
• PostMessage(message_id, data) – 移动数据（高性能）。
• CopyMessage(message_id, data) – 在发送前执行深拷贝。

' --- BEFORE (Rendezvous Dependency) ---
' m.top.updateData = hugeAA 
' Scene.brs has an observer on task.updateData.
' The moment this assignment happens, the threads are "locked."

' --- AFTER (Decoupled Messaging) ---
' [Inside Task Thread]
sub runTask()
    hugeAA = loadMassiveJson()

    queue = CreateObject("roRenderThreadQueue")
    queue.PostMessage("FEED_UPDATE", hugeAA)
end sub

' [Inside Component/Scene .brs]
sub init()
    m.queue = CreateObject("roRenderThreadQueue")
    m.queue.AddMessageHandler("FEED_UPDATE", "onFeedUpdate")
end sub

sub onFeedUpdate(data as Object, info as Object)
    ' data is the moved AA. No Rendezvous ever occurred.
    m.myGrid.content = data
end sub

结论

这种架构转变可以说是自 SceneGraph 以来 Roku 开发中最重要的变化。新的 API 让你不必复制大型数据结构，只需指向它们，从而带来若干切实的好处：

• 低端设备救星： 在 RAM 受限的设备上（例如 Roku Express），深拷贝导致的内存峰值被消除，使得在廉价硬件上也能处理庞大的 JSON 负载。
• “卡顿”终结： 由于 MoveIntoField 和 PostMessage 是 O(1) 操作，RowList 或其他 UI 组件中的微小卡顿消失，使渲染线程保持响应。

相关链接

• Data Transfer APIs – Roku Developer Guide
• Performance Overview Video