Öğretici: modelleri düzenleme

Bu öğreticide şunların nasıl yapıldığını öğreneceksiniz:

Önkoşullar

• Bu öğretici öğretici: arabirimler ve özel modellerüzerinde oluşturulur.

Uzak nesne sınırlarını sorgula ve yerel sınırlara Uygula

Uzak nesnelerle etkileşim kurmak için, ilk olarak etkileşimde bulunmak üzere yerel bir gösterimle ihtiyacımız var. Nesne sınırları , uzak bir nesnenin hızlı bir şekilde işlenmesi için faydalıdır. Uzak sınırlar, yerel varlık bir başvuru olarak kullanılarak ARR 'den sorgulanabilir. Sınır, model uzak oturuma yüklendikten sonra sorgulanır.

Bir modelin sınırları, tümmodelin (örneğin, x, y, z eksenleri için bir merkezi ve boyutu tanımlanmış olan) tüm modeli içeren kutuya göre tanımlanır. Aslında, uzak modelin sınırlarını göstermek için Unity 'nin BoxCollider kullanacağız.

1. Remoterenderedmodel ile aynı dizinde yeni bir komut dosyası oluşturun ve bu dosyayı remotelimitle adlandırın.

2. Komut dosyasının içeriğini aşağıdaki kodla değiştirin:

   // Copyright (c) Microsoft Corporation. All rights reserved.
   // Licensed under the MIT License. See LICENSE in the project root for license information.
   
   using Microsoft.Azure.RemoteRendering;
   using Microsoft.Azure.RemoteRendering.Unity;
   using System;
   using UnityEngine;
   
   [RequireComponent(typeof(BaseRemoteRenderedModel))]
   public class RemoteBounds : BaseRemoteBounds
   {
       //Remote bounds works with a specific remotely rendered model
       private BaseRemoteRenderedModel targetModel = null;
   
       private RemoteBoundsState currentBoundsState = RemoteBoundsState.NotReady;
   
       public override RemoteBoundsState CurrentBoundsState
       {
           get => currentBoundsState;
           protected set
           {
               if (currentBoundsState != value)
               {
                   currentBoundsState = value;
                   BoundsStateChange?.Invoke(value);
               }
           }
       }
   
       public override event Action<RemoteBoundsState> BoundsStateChange;
   
       public void Awake()
       {
           BoundsStateChange += HandleUnityEvents;
           targetModel = GetComponent<BaseRemoteRenderedModel>();
   
           targetModel.ModelStateChange += TargetModel_OnModelStateChange;
           TargetModel_OnModelStateChange(targetModel.CurrentModelState);
       }
   
       private void TargetModel_OnModelStateChange(ModelState state)
       {
           switch (state)
           {
               case ModelState.Loaded:
                   QueryBounds();
                   break;
               default:
                   BoundsBoxCollider.enabled = false;
                   CurrentBoundsState = RemoteBoundsState.NotReady;
                   break;
           }
       }
   
       // Create an async query using the model entity
       async private void QueryBounds()
       {
           //Implement me
       }
   }
   

   Not

   Visual Studio 'da bir hata görürseniz , ' X ' üzerinde talep ediliyor özelliği C# 6 ' da kullanılamaz. Lütfen dil sürümü 7,0 veya üzerini kullanın, bu hata güvenle yoksayılabilir. Bu, Unity 'nin çözümü ve proje üretimi ile ilgilidir.

   Bu betik, Baseremoterenderedmodel uygulayan komut dosyasıyla aynı gameobject öğesine eklenmelidir. Bu durumda, Remoterenderedmodel anlamına gelir. Önceki betiklerle benzer şekilde, bu ilk kod tüm durum değişikliklerini, olayları ve uzak sınırlara ilişkin verileri işleyecektir.

   Uygulamak için yalnızca bir yöntem kaldı: Querylimit'lar. Querylimitler , sınırları zaman uyumsuz olarak getirir, sorgunun sonucunu alır ve yerel BoxCollider uygular.

   Querysınır yöntemi basittir: Uzaktan işleme oturumuna bir sorgu gönderin ve sonucu beklein.

3. Querylimitle yöntemini aşağıdaki tamamlanmış yöntemle değiştirin:

   // Create a query using the model entity
   async private void QueryBounds()
   {
       var remoteBounds = targetModel.ModelEntity.QueryLocalBoundsAsync();
       CurrentBoundsState = RemoteBoundsState.Updating;
       await remoteBounds;
   
       if (remoteBounds.IsCompleted)
       {
           var newBounds = remoteBounds.Result.toUnity();
           BoundsBoxCollider.center = newBounds.center;
           BoundsBoxCollider.size = newBounds.size;
           BoundsBoxCollider.enabled = true;
           CurrentBoundsState = RemoteBoundsState.Ready;
       }
       else
       {
           CurrentBoundsState = RemoteBoundsState.Error;
       }
   }
   

   Başarılı olup olmadığını görmek için sorgu sonucunu denetliyoruz. Yanıtınız evet ise, döndürülen sınırları BoxCollider kabul edebileceği bir biçimde dönüştürün ve uygulayın.

Artık, Remotesınır betiği, Remoterenderedmodel ile aynı oyun nesnesine eklendiğinde, gerekirse bir BoxCollider eklenir ve model Loaded durumuna ulaştığında, sınırlar otomatik olarak sorgulanacaktır ve BoxCollider öğesine uygulanır.

1. Daha önce oluşturulan Testmodel oyunu nesnesini kullanarak remotelimiti bileşenini ekleyin.

2. Betiğin eklendiğini onaylayın.

   

3. Uygulamayı yeniden çalıştırın. Model yüklendikten kısa bir süre sonra uzak nesnenin sınırlarını görürsünüz. Aşağıdaki değerlere benzer bir şey göreceksiniz:

   

Artık Unity nesnesinde doğru sınırlarla yapılandırılmış yerel bir BoxCollider vardır. Sınır, yerel olarak işlenmiş bir nesne için kullandığımız stratejileri kullanarak görselleştirme ve etkileşime izin verir. Örneğin, dönüşüm, fizik ve daha fazlasını değiştirecek betikler.

Taşıma, döndürme ve ölçekleme

Uzaktan işlenen nesneleri taşıma, döndürme ve ölçekleme diğer Unity nesneleriyle aynı şekilde çalışacaktır. Bu yöntemde bulunan Remoterenderingcoordinator, LateUpdate Update Şu anda etkin olan oturumu çağırıyor. UpdateEşitlenecek yerel model varlığı, uzak karşılıklarıyla birlikte dönüşümler olan bir parçasıdır. Uzaktan işlenmiş bir modeli taşımak, döndürmek veya ölçeklendirmek için, yalnızca uzak modeli temsil eden GameObject dönüşümünü taşımanız, döndürmeniz veya ölçeklendirmeniz gerekir. Burada, bir ana oyun nesnesinin, bu kendisine ekli olan Remoterenderedmodel betiğinin dönüşümünü değiştirebiliyoruz.

Bu öğretici, nesne etkileşimi için MRTK kullanıyor. Bir nesnenin taşınması, döndürülmesi ve ölçeklendirilmesi için MRTK 'a özgü uygulamanın çoğu Bu öğreticinin kapsamı dışındadır. Model araçları menüsünde appmenu içinde önceden yapılandırılmış bir model görünüm denetleyicisi vardır.

1. Daha önce oluşturulan Testmodel gameobject 'in sahnede bulunduğundan emin olun.
2. Appmenu prefab 'nin sahnede bulunduğundan emin olun.
3. Sahneyi oynatmak ve Appmenu Içindeki model araçları menüsünü açmak için Unity 'nin Play düğmesine basın.

Appmenu , modeliyle bağlama için bir görünüm denetleyicisi uygulayan bir alt menü modeli araçlarına sahiptir. GameObject bir Remotesınır bileşeni içerdiğinde, görünüm denetleyicisi bir BoxCollider ile nesne etrafında bir sınırlayıcı kutu oluşturan bir mrtk bileşeni olan bir BoundingBox bileşeni ekler. Bir Nesneel etkileşiminden sorumlu olan Objectlıör. Bu komut dosyaları, uzaktan işlenmiş modeli taşımanızı, döndürmemizi ve ölçeklendirmemize olanak sağlayacak.

1. Farenizi oyun paneline taşıyın ve odaklanmak için buraya tıklayın.

2. Mrtk 'nin el benzetiminikullanarak sol SHIFT tuşuna basın ve basılı tutun.

3. El ışın test modelini işaret ettiğinden, sanal bir yandan

   

4. Sol tıklama tuşunu basılı tutarak modeli taşımak için sürükleyin.

Uzaktan işlenmiş içeriğin sınırlayıcı kutusuyla birlikte taşınacağını görmeniz gerekir. Sınırlayıcı kutusuyla uzak içerik arasında bazı gecikme veya gecikme fark edebilirsiniz. Bu gecikme, internet gecikme süresine ve bant genişliğine bağlıdır.

Uzak modellerin ışın dönüştürme ve uzamsal sorguları

Modellerin etrafındaki bir Box Collider, modelin tamamı ile etkileşime geçmek için uygundur, ancak modelin tek tek bölümleriyle etkileşimde bulunmak için yeterince ayrıntılı değildir. Bunu gidermek için, uzak Ray atamakullanabiliriz. Uzak Ray atama, Azure uzaktan Işleme tarafından, ışınları uzak sahneye dönüştürmek ve isabet sonuçlarını yerel olarak döndürmek için sunulan bir API 'dir. Bu teknik, büyük bir modelin alt varlıklarını seçmek veya konum, yüzey normal ve mesafe gibi isabet sonucu bilgileri almak için kullanılabilir.

Test modeli, sorgulanabilen ve seçilen sayıda alt varlık içerir. Şimdilik, seçim seçili varlığın adını Unity konsoluna çıktı. Seçili varlığı vurgulamak için malzemeler, aydınlatma ve efektler bölümünü kontrol edin.

İlk olarak, uzak Ray cast sorguları etrafında statik bir sarmalayıcı oluşturalım. Bu betik, Unity alanında bir konum ve yön kabul eder, bunu uzak Ray cast tarafından kabul edilen veri türlerine dönüştürür ve sonuçları döndürür. Betik, RayCastQueryAsync API 'yi kullanır.

1. Remoteraycaster adlı yeni bir betik oluşturun ve içeriğini şu kodla değiştirin:

   // Copyright (c) Microsoft Corporation. All rights reserved.
   // Licensed under the MIT License. See LICENSE in the project root for license information.
   
   using Microsoft.Azure.RemoteRendering;
   using Microsoft.Azure.RemoteRendering.Unity;
   using System.Linq;
   using System.Threading.Tasks;
   using UnityEngine;
   
   /// <summary>
   /// Wraps the Azure Remote Rendering RayCast queries to easily send requests using Unity data types
   /// </summary>
   public class RemoteRayCaster
   {
       public static double maxDistance = 30.0;
   
       public static async Task<RayCastHit[]> RemoteRayCast(Vector3 origin, Vector3 dir, HitCollectionPolicy hitPolicy = HitCollectionPolicy.ClosestHit)
       {
           if(RemoteRenderingCoordinator.instance.CurrentCoordinatorState == RemoteRenderingCoordinator.RemoteRenderingState.RuntimeConnected)
           {
               var rayCast = new RayCast(origin.toRemotePos(), dir.toRemoteDir(), maxDistance, hitPolicy);
               var result = await RemoteRenderingCoordinator.CurrentSession.Connection.RayCastQueryAsync(rayCast);
               return result.Hits;
           }
           else
           {
               return new RayCastHit[0];
           }
       }
   
       public static async Task<Entity[]> RemoteRayCastEntities(Vector3 origin, Vector3 dir, HitCollectionPolicy hitPolicy = HitCollectionPolicy.ClosestHit)
       {
           var hits = await RemoteRayCast(origin, dir, hitPolicy);
           return hits.Select(hit => hit.HitEntity).Where(entity => entity != null).ToArray();
       }
   }
   

   Not

   Unity, raycasthitadlı bir sınıfa sahiptir ve Azure uzaktan Işleme, Raycasthitadlı bir sınıfa sahiptir. Büyük harf C derleme hatalarını önlemek için önemli bir farktır.

   Remoteraycaster , uzak ışınları geçerli oturuma atama için ortak bir erişim noktası sağlar. Daha belirgin olması için bir MRTK işaretçi işleyicisi daha sonra uygulayacağız. Betik, IMixedRealityPointerHandler Bu komut dosyasının karma gerçeklik işaretçisi olaylarını DINLEYEBILMEMIZ için mrtk öğesine söylediğimiz arabirimi uygular.

2. Remoterayyon Pointerhandler adlı yeni bir betik oluşturun ve kodu şu kodla değiştirin:

   // Copyright (c) Microsoft Corporation. All rights reserved.
   // Licensed under the MIT License. See LICENSE in the project root for license information.
   
   using Microsoft.Azure.RemoteRendering;
   using Microsoft.MixedReality.Toolkit.Input;
   using System;
   using System.Linq;
   using System.Threading.Tasks;
   using UnityEngine;
   
   public class RemoteRayCastPointerHandler : BaseRemoteRayCastPointerHandler, IMixedRealityPointerHandler
   {
       public UnityRemoteEntityEvent OnRemoteEntityClicked = new UnityRemoteEntityEvent();
   
       public override event Action<Entity> RemoteEntityClicked;
   
       public void Awake()
       {
           // Forward events to Unity events
           RemoteEntityClicked += (entity) => OnRemoteEntityClicked?.Invoke(entity);
       }
   
       public async void OnPointerClicked(MixedRealityPointerEventData eventData)
       {
           if (RemoteEntityClicked != null) //Ensure someone is listening before we do the work
           {
               var firstHit = await PointerDataToRemoteRayCast(eventData.Pointer);
               if (firstHit.success)
                   RemoteEntityClicked.Invoke(firstHit.hit.HitEntity);
           }
       }
   
       public void OnPointerDown(MixedRealityPointerEventData eventData) { }
   
       public void OnPointerDragged(MixedRealityPointerEventData eventData) { }
   
       public void OnPointerUp(MixedRealityPointerEventData eventData) { }
   
       private async Task<(bool success, RayCastHit hit)> PointerDataToRemoteRayCast(IMixedRealityPointer pointer, HitCollectionPolicy hitPolicy = HitCollectionPolicy.ClosestHit)
       {
           RayCastHit hit;
           var result = pointer.Result;
           if (result != null)
           {
               var endPoint = result.Details.Point;
               var direction = pointer.Rays[pointer.Result.RayStepIndex].Direction;
               Debug.DrawRay(endPoint, direction, Color.green, 0);
               hit = (await RemoteRayCaster.RemoteRayCast(endPoint, direction, hitPolicy)).FirstOrDefault();
           }
           else
           {
               hit = new RayCastHit();
           }
           return (hit.HitEntity != null, hit);
       }
   }
   

OnPointerClicked "Tıklamız" gibi bir işaretçi bir Collider üzerinde ' tıkladığı zaman, remoterk,, mrtk tarafından çağırılır. Bundan sonra, PointerDataToRemoteRayCast işaretçinin sonucunu bir nokta ve yöne dönüştürmek için çağırılır. Bu nokta ve yön, uzak oturumunda uzak bir ışın dönüştürmek için kullanılır.

Tıklama üzerinde ışın dönüşümü için gönderme istekleri, uzak nesneleri sorgulamak için etkili bir stratejidir. Ancak, imleç modelin kendisini değil, Collider Box ile çakışdığından ideal bir kullanıcı deneyimi değildir.

Ayrıca, Uzak oturumdaki ışınını daha sık oluşturan yeni bir MRTK işaretçisi de oluşturabilirsiniz. Bu daha karmaşık bir yaklaşım olsa da, Kullanıcı deneyimi daha iyi olacaktır. Bu strateji, Bu öğreticinin kapsamı dışındadır, ancak bu yaklaşımın bir örneği, ARR örnekleri deposundabulunan gösterimi uygulamasında görülebilir.

Bir Ray cast, remoterbir Pointerhandler öğesinde başarıyla tamamlandığında, bu isabet Entity OnRemoteEntityClicked Unity olayından yayılır. Bu olaya yanıt vermek için, öğesini kabul eden Entity ve üzerinde bir eylem gerçekleştiren bir yardımcı komut dosyası oluşturacağız. Hata ayıklama günlüğüne adını yazdırmak için betiği almaya başlayalım Entity .

1. Remoteentityhelper adlı yeni bir betik oluşturun ve içeriğini aşağıdaki kodla değiştirin:

   // Copyright (c) Microsoft Corporation. All rights reserved.
   // Licensed under the MIT License. See LICENSE in the project root for license information.
   
   using Microsoft.Azure.RemoteRendering;
   using Microsoft.Azure.RemoteRendering.Unity;
   using UnityEngine;
   
   public class RemoteEntityHelper : MonoBehaviour
   {
       public void EntityToDebugLog(Entity entity)
       {
           Debug.Log(entity.Name);
       }
   }
   

2. Daha önce oluşturulan Testmodel oyunobject ' te, hem Remoterayyon pointerhandler bileşeni hem de remoteentityhelper bileşenini ekleyin.

3. EntityToDebugLogOlayına yöntemine atayın OnRemoteEntityClicked . Olayın çıkış türü ve yönteminin giriş türü eşleşiyorsa, Unity 'nin dinamik olay kancaı ' nı kullanarak olay değeri otomatik olarak yönteme geçer.

   1. Yeni bir geri çağırma alanı oluştur
   2. Uzak varlık Yardımcısı bileşenini nesne alanına, üst gameobject atama nesnesine başvuracak şekilde sürükleyin
   3. EntityToDebugLogGeri çağırma için geri çağırma

4. Unity düzenleyicisinde Yürüt ' e basarak sahneyi başlatın, uzak bir oturuma bağlanın ve test modelini yükleyin.

5. MRTK 'nin el simülasyonu kullanarak sol SHIFT tuşuna basın ve basılı tutun.

6. El ışın test modelini işaret ettiğinden, sanal bir yandan

7. Bir AIR tap benzetimini yapmak için uzun tıklama OnPointerClicked olayı yürütülüyor.

8. Seçili alt varlık adına sahip bir günlük iletisi için Unity konsolunu gözlemleyin. Örneğin:

Uzak nesne grafiğini Unity hiyerarşisine eşitleme

Bu noktaya kadar, yalnızca modelin tamamını temsil eden tek bir yerel oyun nesnesi gördük. Bu, tüm modelin işlenmesi ve düzenlemesi için iyi bir sonuç verir. Ancak, etkileri uygulamak veya belirli alt varlıkları işlemek istiyorsam, bu varlıkları temsil etmek için yerel oyun nesneleri oluşturmanız gerekir. İlk olarak, test modelinde el ile keşfedebiliriz.

1. Sahneyi başlatın ve test modelini yükleyin.
2. Unity 'nin hiyerarşisinde Testmodel gameobject alt öğelerini genişletin ve TestModel_Entity gameobject ' i seçin.
3. Denetçisinde alt öğeleri göster düğmesine tıklayın.
4. Hiyerarşide alt öğeleri genişletmeye ve alt öğelerin büyük bir listesi gösterilene kadar alt öğeleri göster ' e tıklayarak devam edin.

Onlarca varlıkların listesi artık hiyerarşiyi dolduracaktır. Bunlardan birinin seçilmesi, Transform RemoteEntitySyncObject Inspector 'daki ve bileşenlerini gösterir. Varsayılan olarak, her bir varlık her karede otomatik olarak eşitlenmez, bu nedenle üzerinde yerel değişiklikler Transform sunucu ile eşitlenmez. Her çerçevenin eşitlemesini denetleyebilir ve sonra sahneyi sahne görünümünde taşıyabilir, ölçeklendirebilir veya döndürebilir, sahne görünümünde işlenen modeli görmezsiniz, modelin konum ve döndürme görsel güncelini görmek için oyun görünümünü izleyin.

Aynı işlem programlı bir şekilde yapılabilir ve belirli uzak varlıkları değiştirmenin ilk adımıdır.

1. Remoteentityhelper betiğini aşağıdaki yöntemi de içerecek şekilde değiştirin:

   public void MakeSyncedGameObject(Entity entity)
   {
       var entityGameObject = entity.GetOrCreateGameObject(UnityCreationMode.DoNotCreateUnityComponents);
       var sync = entityGameObject.GetComponent<RemoteEntitySyncObject>();
       sync.SyncEveryFrame = true;
   }
   

2. Remoterayyon Pointerhandler olayına ek bir geri çağırma ekleyin OnRemoteEntityClicked ve bunu olarak ayarlayarak MakeSyncedGameObject .

3. MRTK 'nin el simülasyonu kullanarak sol SHIFT tuşuna basın ve basılı tutun.

4. El ışın test modelini işaret ettiğinden, sanal bir yandan

5. Bir AIR tap benzetimini yapmak için uzun tıklama OnPointerClicked olayı yürütülüyor.

6. Tıklamış varlığı temsil eden yeni bir alt nesne görmek için hiyerarşiyi denetleyip genişletin.

7. Test ettikten sonra, MakeSyncedGameObject Bu, daha sonra diğer efektlerin bir parçası olarak birleştireceğiz için geri çağırma işlemini kaldırın.

Yerel bir örnek oluşturmak ve bunu otomatik olarak eşitlemeye getirmek, alt varlıkların işlenmesine yönelik ilk adımdır. Modeli bir bütün olarak işlemek için kullandığımız tekniklerin aynısına de alt varlıklarda de erişilebilir. Örneğin, bir varlığın eşitlenmiş yerel bir örneğini oluşturduktan sonra, sınırlarını sorgulayabilir ve kullanıcı tarafında hareket altına alınabilmesini sağlamak için işleme işleyicileri ekleyebilirsiniz.

Sonraki adımlar

Artık uzaktan işlenmiş modellerinizi işleyebilir ve bunlarla etkileşim kurabilirsiniz! Sonraki öğreticide, malzemeleri değiştirmeyi, aydınlatmayı değiştirmeyi ve uzaktan işlenmiş modellere etkileri uygulamayı ele alacağız.