RealityUI下載 - RealityUI源代碼下載

RealityUI

其他源碼

visionOS Support

下載

真人島

真人島是用於RealityKit的實用程序和UI對象的集合。 REANEUI中包含的UI對象旨在提供熟悉的用戶界面標準，但在3D設置中，用於通過RealityKit增強和虛擬現實。

真人島還擁有一系列通過觸摸或拖動交互與任何實體接口的組件。

RENAYEKIT VR空間中的RealityUi元素

要求

iOS 13，MacOS 10.15或Visionos 1.0
Swift 5.8
XCode 13

內容

真人島
- 要求
- 內容
- 安裝
  - Swift軟件包管理器
- 用法
  - 註冊真人ui組件
  - 激活手勢
    - Visionos
    - iOS/macOS
- 控制實體
  - 魯伊斯維奇
  - Ruistepper
  - Ruislider
  - Ruibutton
- 手勢
  - 拖
  - 轉動
  - 輕敲
- 動畫
  - 旋轉
  - 搖
- 文字
- 更多的

安裝

Swift軟件包管理器

將此存儲庫的URL添加到您的Xcode 11+項目Project > Swift Packages下的URL。

https://github.com/maxxfrazer/RealityUI.git

用法

將import RealityUI添加到Swift文件的頂部以啟動。

註冊真人ui組件

在使用之前，必須在使用真元中使用的所有組件在使用之前註冊，只需在您的應用程序中的任何地方都撥打RealityUI.registerComponents()在初始化RUI的任何類中的任何類中，以避免與此問題進行問題。有關註冊組件的含義的更多信息，請在此處查看Apple的文檔。

激活手勢

Visionos

使用Visionos，可以使用View/addRUIDragGesture()或View/addRUITapGesture()修飾符在真人秀上啟用手勢，也可以通過.gesture(RUIDragGesture())或.gesture(RUITapGesture())直接添加手勢。真人秀可能看起來像這樣：

 RealityView { content in
    let swtch = RUISwitch ( )
    swtch . scale = . init ( repeating : 0.1 )
    content . add ( swtch )
} . addRUIDragGesture ( )

上面的摘要在場景中添加了一個交互開關/切換。

例如，此手勢適用於RuidragComponent的任何實體，例如：

 RealityView { content in
    let movable = try ! await ModelEntity ( named : " toy_biplane " )
    movable . generateCollisionShapes ( recursive : false )

    movable . components . set ( RUIDragComponent ( type : . move ( nil ) ) )
    movable . components . set ( InputTargetComponent ( ) )

    content . add ( movable )
} . addRUIDragGesture ( )

在視覺模擬器中移動雙翼飛機

iOS/macOS

可以通過調用RealityUI.enableGestures(.all, on: ARView)來啟用真人秀手勢，其中ARView是您的Arview對象的實例。

Ruislider，Ruiswitch，Ruistepper和Ruibutton都使用RUIDragComponent ，這需要.ruiDrag 。如果要添加使用組件RUITapComponent元素，則可以使用engure .tap 。我只建議在啟用手勢時使用.all ，因為隨著eraneui的發展，這些手勢不可避免地會四處移動。

RealityUI.enableGestures(.all, on: arView)

控制實體

默認情況下，所有真人秀實體都很大。這用於標準化尺寸，以便您始終知道會發生什麼。例如，所有的UI拇指都是直徑為1米的球體，在RealityKit中為1個單位，±任何填充調整。默認情況下，所有真人秀實體面對[0, 0, -1] 。要讓它們指向用戶攝像機或.zero ，您可以使用.look(at:,from:,relativeTo:)方法類似so： .look(at: .zero, from: [0, 0, 1]) 。或者，如果您希望將其立即轉動，如果將其定位在[0, 0, -1]處，則將方向設置為simd_quatf(angle: .pi, axis: [0, 1, 0]) 。使用.look（）方法在此處通過設置at:值為方向應使用該按鈕的方向。