Örnek uygulamayı çalıştırma: HoloLens - Unity (C#)
Bu hızlı başlangıçta Unity (C#) kullanarak HoloLens için Azure Spatial Anchors örnek uygulamasını çalıştıracaksınız. Spatial Anchors, zaman içinde cihazlar arasında konumlarını kalıcı hale getiren nesnelerle karma gerçeklik deneyimleri oluşturmanıza olanak tanıyan platformlar arası bir geliştirici hizmetidir. İşiniz bittiğinde, uzamsal bir tutturucu kaydedebilen ve geri çağırabilen Unity ile oluşturulmuş bir HoloLens uygulamanız olacak.
Nasıl yapılacağını öğrenin:
- Spatial Anchors hesabı oluşturun.
- Unity derleme ayarlarını hazırlayın.
- Spatial Anchors hesap tanımlayıcısını ve hesap anahtarını yapılandırın.
- HoloLens Visual Studio projesini dışarı aktarın.
- Uygulamayı dağıtın ve bir HoloLens cihazında çalıştırın.
Azure aboneliğiniz yoksa başlamadan önce birücretsiz Azure hesabı oluşturun.
Önkoşullar
Bu hızlı başlangıcı tamamlamak için:
- Geliştirici modu etkin bir HoloLens cihazına ihtiyacınız vardır. HoloLens 2 için Windows 10 Mayıs 2020 Güncelleştirmesi veya üstü cihaza yüklenmelidir. HoloLens'te en son sürüme güncelleştirmek için Ayarlar uygulamasını açın, Güncelleştirme ve Güvenlik'e gidin ve güncelleştirmeleri denetle'yi seçin.
- Visual Studio 2019 veya üzeri yüklü bir Windows bilgisayar gerekir. Visual Studio yüklemeniz Evrensel Windows Platformu geliştirme iş yükünü ve Windows 10 SDK (10.0.18362.0 veya daha yeni) bileşenini içermelidir. Ayrıca Windows için Git'i ve Git LFS'yi de yüklemeniz gerekir.
- Unity'nin yüklü olması gerekir. Desteklenen sürümler ve gerekli özellikler için Unity projesi kurulum sayfasını ziyaret edin.
Spatial Anchors kaynağı oluşturma
Azure portalına gidin.
Sol bölmede Kaynak oluştur'u seçin.
Spatial Anchors'ı aramak için arama kutusunu kullanın.
Uzamsal Tutturucular'ı ve ardından Oluştur'u seçin.
Spatial Anchors Hesabı bölmesinde aşağıdakileri yapın:
Normal alfasayısal karakterleri kullanarak benzersiz bir kaynak adı girin.
Kaynağı eklemek istediğiniz aboneliği seçin.
Yeni oluştur'u seçerek bir kaynak grubu oluşturun. MyResourceGroup olarak adlandırın ve tamam'ı seçin.
Kaynak grubu, web uygulamaları, veritabanları ve depolama hesapları gibi Azure kaynaklarının dağıtıldığı ve yönetildiği mantıksal bir kapsayıcıdır. Örneğin, daha sonra tek bir basit adımda kaynak grubun tamamını silmeyi seçebilirsiniz.
Kaynağın yerleştirildiği konumu (bölgeyi) seçin.
Kaynağı oluşturmaya başlamak için Oluştur'u seçin.
Kaynak oluşturulduktan sonra Azure portalı dağıtımınızın tamamlandığını gösterir.
Kaynağa git’i seçin. Artık kaynak özelliklerini görüntüleyebilirsiniz.
Kaynağın Hesap Kimliği değerini daha sonra kullanmak üzere bir metin düzenleyicisine kopyalayın.
Ayrıca kaynağın Hesap Etki Alanı değerini daha sonra kullanmak üzere bir metin düzenleyicisine kopyalayın.
Ayarlar altında Erişim Anahtarı'yı seçin. Birincil anahtar değeri olan Hesap Anahtarı'nı daha sonra kullanmak üzere bir metin düzenleyicisine kopyalayın.
Örnek projeyi indirme ve SDK'yı içeri aktarma
Kopya Örnekleri Deposu
Aşağıdaki komutları çalıştırarak örnek deposunu kopyalayın:
git clone https://github.com/Azure/azure-spatial-anchors-samples.git
cd ./azure-spatial-anchors-samples
ASA SDK'sı içeri aktarma
HoloLens platformu için gereken ASA SDK paketlerini indirmek ve içeri aktarmak için buradaki yönergeleri izleyin.
Unity'yi yapılandırma
Unity'de projeyi Unity klasöründe açın. Unity, projedeki sürümle makinenizde yüklü olan sürüm arasında bir fark olup olmadığını size sorabilir. Unity Editor sürümünüz projenin oluşturulduğu sürümden daha yeni olduğu sürece bu uyarı sorun olmaz. Sürümünüz daha yeniyse Devam'ı seçin. Sürümünüz projenin ihtiyaç duyduğu sürümden daha eskiyse Çık'ı seçin ve Unity Düzenleyicinizi yükseltin.
Dosya>Derleme Ayarlar'yi seçerek Derleme Ayarlar'yi açın.
Platform bölümünde Evrensel Windows Platformu'ı seçin. Hedef Cihazı HoloLens olarak değiştirin.
Platformu Evrensel Windows Platformu olarak değiştirmek için Platform Değiştir'i seçin. Unity, eksikse UWP destek bileşenlerini yüklemenizi isteyebilir.
Derleme Ayarlar penceresini kapatın.
Hesap bilgilerini yapılandırma
Sonraki adım, uygulamayı hesap bilgilerinizi kullanacak şekilde yapılandırmaktır. Hesap Anahtarı, Hesap Kimliği ve Hesap Etki Alanı değerlerini daha önce "Spatial Anchors kaynağı oluşturma" bölümünde bir metin düzenleyicisine kopyalamıştınız.
Proje bölmesinde öğesine Assets\AzureSpatialAnchors.SDK\Resourcesgidin.
SpatialAnchorConfig'i seçin. Denetçi bölmesinde, Spatial Anchors Hesap Anahtarı değeri olarak değerini, Account ID Spatial Anchors Hesap Kimliği değeri olarak ve Account Domain Spatial Anchors Hesap Etki Alanı değeri olarak değerini girinAccount Key.
HoloLens Visual Studio projesini dışarı aktarma
Dosya>Derleme Ayarlar'yi seçerek Derleme Ayarlar'yi açın.
Derlemedeki Sahneler'in altında tüm sahnelerin yanında onay işareti olduğundan emin olun.
Oluştur'a tıklayın. İletişim kutusunda HoloLens Visual Studio projesinin dışarı aktarıldığı klasörü seçin.
Dışarı aktarma işlemi tamamlandığında dışarı aktarılan HoloLens projesini içeren bir klasör görüntülenir.
HoloLens uygulamasını dağıtma
Klasörde HelloAR U3D.sln'ye çift tıklayarak projeyi Visual Studio'da açın.
Çözüm Yapılandırmasını Yayın olarak değiştirin, Çözüm Platformu'nı x86 olarak değiştirin ve dağıtım hedefi seçeneklerinden Cihaz'ı seçin.
HoloLens 2 kullanıyorsanız, x86 yerine Çözüm Platformu olarak ARM64 kullanın.
HoloLens cihazını açın, oturum açın ve usb kablosu kullanarak cihazı bilgisayara bağlayın.
Hata ayıklama Hata ayıklama>Uygulamanızı dağıtmak ve hata ayıklamayı başlatmak için Hata ayıklamayı başlat'ı seçin.
Uygulamada, okları kullanarak BasicDemo'yu seçin, ardından demoyu çalıştırmak için Git! düğmesine basın. Yer işareti yerleştirmek ve geri çağırmak için yönergeleri izleyin.
Visual Studio'da Hata Ayıklamayı Durdur veya Shift+F5 tuşlarına basarak uygulamayı durdurun.
Kaynakları temizleme
Önceki adımlarda, bir kaynak grubunda Azure kaynakları oluşturdunuz. İleride bu kaynaklara ihtiyaç duymayacağınızı düşünüyorsanız kaynakları silmek için kaynak grubunu silebilirsiniz.
Azure portalı menüsünden veya Giriş sayfasında Kaynak grupları'nı seçin. Ardından Kaynak grupları sayfasında myResourceGroup öğesini seçin.
myResourceGroup sayfasında, silmek istediğiniz kaynakların listelenmiş kaynaklar olduğundan emin olun.
Kaynak grubunu sil'i seçin, onaylamak için metin kutusuna myResourceGroup yazın ve sil'i seçin.
Sonraki adımlar
Bu hızlı başlangıçta bir Spatial Anchors hesabı oluşturdunuz. Ardından uzamsal tutturucuları kaydetmek ve geri çağırmak için bir uygulama yapılandırıp dağıttınız. Uzamsal bağlantıları diğer cihazlarla paylaşabilmek için uygulamayı geliştirme hakkında daha fazla bilgi edinmek için sonraki öğreticiye geçin.