{"id":19500224,"url":"https://github.com/cesiumgs/cesium-unity-samples","last_synced_at":"2025-05-16T15:07:54.564Z","repository":{"id":63989315,"uuid":"528753467","full_name":"CesiumGS/cesium-unity-samples","owner":"CesiumGS","description":"Sample project for Cesium for Unity","archived":false,"fork":false,"pushed_at":"2025-05-01T08:12:31.000Z","size":76112,"stargazers_count":253,"open_issues_count":5,"forks_count":46,"subscribers_count":20,"default_branch":"main","last_synced_at":"2025-05-01T09:24:30.277Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/CesiumGS.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2022-08-25T08:05:57.000Z","updated_at":"2025-05-01T08:12:25.000Z","dependencies_parsed_at":"2024-03-05T01:31:41.510Z","dependency_job_id":"c3052cde-b2fc-47c4-83bf-6aedf1373b33","html_url":"https://github.com/CesiumGS/cesium-unity-samples","commit_stats":{"total_commits":185,"total_committers":7,"mean_commits":"26.428571428571427","dds":0.6702702702702703,"last_synced_commit":"3c6ac31c83c1aa2eef532a40087cd7e3df55d01f"},"previous_names":[],"tags_count":37,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CesiumGS%2Fcesium-unity-samples","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CesiumGS%2Fcesium-unity-samples/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CesiumGS%2Fcesium-unity-samples/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CesiumGS%2Fcesium-unity-samples/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/CesiumGS","download_url":"https://codeload.github.com/CesiumGS/cesium-unity-samples/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254553958,"owners_count":22090417,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-10T22:07:54.116Z","updated_at":"2025-05-16T15:07:49.554Z","avatar_url":"https://github.com/CesiumGS.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![Cesium for Unity Logo](Images~/Cesium_for_Unity-Logo-WhiteBGH.jpg)](https://cesium.com/)\n\n# Cesium for Unity Samples\n\nThe Cesium for Unity Samples is a starter project to learn and explore the [Cesium for Unity](https://cesium.com/platform/cesium-for-unity?utm_source=github\u0026utm_medium=github\u0026utm_campaign=unity) plugin.\n\nThe scenes in this project will walk you through the plugin's features and demonstrate global-scale content, applications, and experiences in Unity 3D.\n\nThe source code for Cesium for Unity itself may be found in the [cesium-unity](https://github.com/CesiumGS/cesium-unity) repo.\n\n![Aerometrex Photogrammetry of San Francisco in Cesium for Unity](Images~/san_francisco.jpg)\n*\u003cp align=\"center\"\u003ePhotogrammetry of San Francisco, California captured by Aerometrex, visualized using Cesium for Unity.\u003cbr\u003eOpen the \u003cb\u003e03_CesiumSanFrancisco\u003c/b\u003e scene in Cesium for Unity Samples to experience it yourself!\u003c/p\u003e*\n\n### :rocket: Get Started\n\n1. **[Download Cesium for Unity Samples](https://github.com/CesiumGS/cesium-unity-samples/releases/latest)**.\n2. Extract the `.zip` file into a suitable location on your computer.\n3. If you have [Unity Hub](https://unity.com/unity-hub) installed, click the \"Open\" button under the \"Projects\" tab. Otherwise, open the Unity Editor directly and select \"Open Project\". Then, point it to the extracted directory. Unity will load the project and also download Cesium for Unity using the Package Manager.\n4. In the Asset Browser, select and load `Assets -\u003e Scenes -\u003e 01_CesiumWorld`. You can also select other scenes as you browse and explore the samples.\n\nHave questions? Ask them on the [community forum](https://community.cesium.com).\n\n## :mountain: Level Descriptions\n\n### :one: Level 1 - Cesium World\n\nThe sample levels begin with a scene in San Francisco. You'll see [Cesium World Terrain](https://cesium.com/platform/cesium-ion/content/cesium-world-terrain/) and [Cesium OSM Buildings](https://cesium.com/platform/cesium-ion/content/cesium-osm-buildings/) in this scene. This level is designed to familiarize you with the core Cesium game objects and components, like Cesium World Terrain and Cesium Georeference.\n\nBe sure to sign into your Cesium ion account using the Cesium button in the toolbar.\n\n### :two: Level 2 - Melbourne Photogrammetry\n\nIn this scene, explore high-resolution photogrammetry data of Melbourne. This data is streamed from Cesium ion with the 3D Tiles format, a spatial index for streaming massive 3D content over the web. 3D Tiles makes it possible to stream hundreds of gigabytes of data over the web using hierarchical level of detail, spatial subdivision, and runtime optimizations.\n\nSee how this scene was created with the [Adding Datasets tutorial](https://cesium.com/learn/unity/unity-datasets/).\n\n### :three: Level 3 - San Francisco Photogrammetry with a Unity Character Controller\n\nIn this scene, explore even more high-resolution photogrammetry data of San Francisco using a third-person character controller. Whereas Melbourne allowed you to freely fly around and explore, in this scene you'll walk right up to the real-world data. When streaming content through Cesium for Unity, physics and gravity will continue to work as expected with your character controllers.\n\nGrab some cool screenshots to share with us as you explore and customize the scenes.\n\n![Photogrammetry of the Ferry Building in San Francisco, CA captured by [Aerometrex](https://aerometrex.com.au/) and visualized in Unity 3D using Cesium for Unity.](Images~/ferry_building.jpg)\n*\u003cp align=\"center\"\u003ePhotogrammetry of the Ferry Building in San Francisco, CA captured by [Aerometrex](https://aerometrex.com.au/).\u003cbr\u003eOpen \u003cb\u003e03_CesiumSanFrancisco\u003c/b\u003e in the Cesium for Unity Samples to walk around the dataset.\u003c/p\u003e*\n\n### :four: Level 4 - Using Subscenes to Explore the World\n\nWith Cesium for Unity, you can build experiences in different locations around the world, without even changing scenes. In this level, we've added a few locations around the world that you can explore. Enter play mode and jump between locations by pressing the 1-4 keys on your keyboard. These levels are loaded in and georeferenced using the `CesiumSubScene` component.\n\nYou can also add your own locations, like your hometown or your favorite vacation spot. Check out the [Sub-scenes tutorial](https://cesium.com/learn/unity/unity-subscenes/) to learn how.\n\n### :five: Level 5 - Metadata\n\nCesium for Unity enables you to access metadata encoded in your 3D Tiles datasets. In this scene, explore the buildings in New York City and see what information is included in the tileset about each building.\n\n![Metadata of New York City buildings visualized.](Images~/metadata.jpg)\n*\u003cp align=\"center\"\u003eMetadata of New York City buildings visualized.\u003cbr\u003eOpen \u003cb\u003e05_CesiumMetadata\u003c/b\u003e in the Cesium for Unity Samples to explore the New York City buildings' metadata.\u003c/p\u003e*\n\n### :six: Level 6 - Point Clouds\n\nCesium for Unity supports rendering point cloud 3D Tilesets in addition to terrain and photogrammetry datasets. In this scene, you can explore several point cloud datasets around the world. Feel free to add your own point clouds as well.\n\n![Point Cloud of Melbourne, Australia visualized using Cesium for Unity.](Images~/melbourne_point_cloud.jpg)\n*\u003cp align=\"center\"\u003ePoint Cloud of Melbourne, Australia visualized using Cesium for Unity.\u003cbr\u003eOpen \u003cb\u003e06_CesiumPointClouds\u003c/b\u003e in the Cesium for Unity Samples to explore multiple point cloud datasets, including the Melbourne Point Cloud.\u003c/p\u003e*\n\n### :seven: Level 7 - Photorealistic 3D Tiles via Google Maps Platform\n\nExplore the world through Photorealistic 3D Tiles streamed via Google Maps Platform. You can learn how to use Photorealistic 3D Tiles in your own \nprojects in the [Photorealistic 3D Tiles from Google Maps Platform tutorial](https://cesium.com/learn/unity/unity-photorealistic-3d-tiles).\n\n![The Googleplex in Mountain View, California visualized with Photorealistic 3D Tiles in Cesium for Unity.](Images~/googleplex.jpeg)\n\n*\u003cp align=\"center\"\u003eThe Googleplex in Mountain View, California visualized with Photorealistic 3D Tiles in Cesium for Unity.\u003cbr\u003eOpen \u003cb\u003e07_CesiumGoogleMapsTiles\u003c/b\u003e in the Cesium for Unity Samples to explore the world as Photorealistic 3D Tiles.\u003c/p\u003e*\n\n### :eight: Level 8 - Architectural Design\n\nThis level showcases an architectural design model streamed into Unity using 3D Tiles. It demonstrates the ability to toggle the visibility of different design layers and click on individual building features to display associated metadata.\n\n![The Googleplex in Mountain View, California visualized with Photorealistic 3D Tiles in Cesium for Unity.](Images~/architectural_design.jpg)\n\n*\u003cp align=\"center\"\u003eSnowdon Sample Model from Autodesk Revit, streamed with 3D Tiles and visualized using Cesium for Unity.\u003cbr\u003eOpen \u003cb\u003e08_CesiumArchitecturalDesign\u003c/b\u003e in the Cesium for Unity Samples to learn more about streaming architectural designs using 3D Tiles.\u003c/p\u003e*\n\n### :goggles: :one: VR Level 1 - Denver Photogrammetry\n\nCesium for Unity supports virtual reality platforms. This level is set up for users with VR headsets to get started quickly. In this scene, explore high-resolution photogrammetry data of Denver, Colorado with VR controller support. To build this for the Oculus Quest 2, open **VR01_CesiumDenver** in the Unity Editor and follow the instructions to build an `APK` file for the headset. These instructions also appear in the UI of the scene itself.\n\n1. Ensure that your Unity Editor has Android build support. If not, follow the instructions [here](https://docs.unity3d.com/Manual/android-sdksetup.html) to set it up.\n2. Go to `File -\u003e Build Settings` and change the platform to Android.\n3. Remove the original sample scene from the scenes list, then click the \"Add Open Scenes\" button.\n4. Go to `Edit -\u003e Project Settings`. Scroll down to find and click on \"XR Plug-in Management\".\n5. Go to the \"Android\" section and check the box next to \"OpenXR\".\n6. Finally, in the Build Settings window, click \"Build and Run\" to build an `APK`.\n\n### :goggles: :two: VR Level 2 - Metadata in VR\n\nIn this scene, experience a miniature version of New York City using an Oculus Quest 2 and the XR Interaction Toolkit. You can walk around and point at buildings with your controller to view their detailed metadata.\n\n### :goggles: :three: VR Level 3 - New York City Landmarks in Mixed Reality\n\n**This sample requires Unity 2022.3.11f or newer.**\n\nThis demo is intended for use with the Magic Leap 2 headset and SDK. In this scene, explore the New York City skyline visualized with Google Photorealistic 3D Tiles. You can visit a set of interesting locations in and around Manhattan, as well as view building metadata while you walk through the streets in Mixed Reality. \n\nUpon opening the **VR03_CesiumMagicLeap** scene or playing it in the editor, you will be prompted with instructions to configure the project for Magic Leap development. The scene will show you prompts that handle most of the configuration necessary. To build for the Magic Leap, follow these instructions:\n\n1. Open the scene in the editor.\n2. As prompted, [follow the steps in the Magic Leap documentation](https://developer-docs.magicleap.cloud/docs/guides/unity/getting-started/configure-unity-settings/#import-magic-leap-unity-sdk) to install the Magic Leap SDK in the project.\n3. Once installed, press play in the editor. This opens a prompt that will automatically change the project's Build Settings for the Magic Leap. Press \"Ok\" and wait.\n4. Once completed, check `Edit -\u003e Project Settings -\u003e XR Plug-in Management -\u003e Project Validation` and make sure no issues are present. If there are, resolve them by clicking \"Fix\" next to each one.\n5. Go to `File -\u003e Build Settings` and click \"Build and Run\" to create an APK and launch it on the headset.\n\n![New York City landmarks visualized with Photorealistic 3D Tiles in Cesium for Unity, rendered on the Magic Leap 2 headset.](Images~/new_york_magic_leap.jpg)\n\n*\u003cp align=\"center\"\u003eNew York City landmarks visualized with Photorealistic 3D Tiles in Cesium for Unity, as rendered on the Magic Leap 2 headset.\u003cbr\u003eOpen \u003cb\u003eVR03_CesiumMagicLeap\u003c/b\u003e in the Cesium for Unity Samples to explore the New York City skyline.\u003c/p\u003e*\n\n### :green_book:License\n\n[Apache 2.0](http://www.apache.org/licenses/LICENSE-2.0.html). Cesium for Unity Samples is free to use as starter project for both commercial and non-commercial use.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcesiumgs%2Fcesium-unity-samples","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcesiumgs%2Fcesium-unity-samples","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcesiumgs%2Fcesium-unity-samples/lists"}