Overview

Hosting Services is a development tool that provides an integrated facility for using Addressable Assets configuration data to serve packed content to local or network-connected application builds from within the Unity Editor. Hosting Services can improve iteration velocity when testing packed content and can also serve content to connected clients on local and remote networks.

譯：Hosting Services是一種開發(fā)工具，提供了一個集成設(shè)施，可以使用Addressable Assets配置數(shù)據(jù)從Unity編輯器內(nèi)部為本地或網(wǎng)絡(luò)連接的應(yīng)用程序構(gòu)建提供打包內(nèi)容。Hosting Services可以在測試打包內(nèi)容時提高迭代速度，并且還可以向本地和遠程網(wǎng)絡(luò)上連接的客戶端提供內(nèi)容。

Packed mode testing and iteration(打包模式測試和迭代)

Moving from Editor Play mode testing to platform application build testing introduces complexities and time costs to the development process. Hosting Services provide extensible Editor-embedded content delivery services that map directly to your Addressables group configuration. Using a custom Addressables profile, you can configure your application to load all content from the Unity Editor itself. This includes builds deployed to mobile devices, or any other platform, that have network access to your development system.

譯：從編輯器播放模式測試轉(zhuǎn)移到平臺應(yīng)用程序構(gòu)建測試引入了開發(fā)過程中的復(fù)雜性和時間成本。Hosting Services提供可擴展的嵌入式內(nèi)容交付服務(wù)，直接映射到您的Addressables組配置，從而提高了迭代速度。使用自定義的Addressables配置文件，您可以配置應(yīng)用程序從Unity編輯器本身加載所有內(nèi)容。這包括部署到移動設(shè)備或任何其他平臺的構(gòu)建，這些平臺可以訪問您的開發(fā)系統(tǒng)。

Setup

This article details the initial setup of Asset Hosting Services for your project. While the setup guide focuses on Editor workflows, you can use the API to configure Hosting Services by setting the?HostingServicesManager?property of the?AddressableAssetSettings?class.

譯：本文詳細介紹了如何為項目設(shè)置Asset Hosting Services。雖然設(shè)置指南側(cè)重于編輯器工作流程，但您也可以使用API通過設(shè)置AddressableAssetSettings類的HostingServicesManager屬性來配置Hosting Services。

Configuring a new Hosting Service

Use the?Hosting window?to add, configure, and enable new Hosting Services. In the Editor, select?Window?>?Asset Management?>?Addressables?>?Hosting, or click the?Tools?>?Window?>?Hosting Services?button from the?Addressables Groups?window menu to access the?Addressables Hosting?window.

譯：使用Hosting窗口添加、配置和啟用新的Hosting Services。在編輯器中，選擇窗口>資產(chǎn)管理>Addressables>Hosting，或從Addressables組窗口菜單中單擊工具>窗口>Hosting Services按鈕以訪問Addressables Hosting窗口。

To add a new Local Hosting Service, click the?Create?>?Local Hosting?button.

譯：要添加新的本地Hosting Service，請單擊Create > Local Hosting按鈕。

Note: For more information on implementing custom hosting service types, see the section on?custom services.

譯：注意：有關(guān)實現(xiàn)自定義Hosting Service類型的更多信息，請參見自定義服務(wù)部分。

The newly added service appears in the?Hosting Services?section of the?Addressables Hosting?window. Use the?Service Name?field enter a name for the service.

譯：新添加的服務(wù)將出現(xiàn)在Addressables Hosting窗口的Hosting Services部分。使用Service Name字段輸入服務(wù)名稱。

The new service defaults to the disabled state. To start the service, select the?Enable?check box.

譯：新服務(wù)默認處于禁用狀態(tài)。要啟動服務(wù)，請選擇Enable復(fù)選框。

The HTTP Hosting Service automatically assigns a port number when it starts. The service saves the port number and reuses it between Unity sessions. To choose a different port, either assign a specific port number in the?Port?field, or click the?Reset?button to assign a different, random port number.

譯：HTTP Hosting Service在啟動時會自動分配端口號。該服務(wù)保存端口號并在Unity會話之間重復(fù)使用。要選擇不同的端口，請在端口字段中分配特定的端口號，或單擊Reset按鈕分配不同的隨機端口號

In Editor versions 2022.1 and above, HTTP downloads are disallowed by default. In order for the default?HTTPHostingService?to work correctly, you need to set the?Allow downloads over HTTP?setting in?Edit?>?Project Settings...?>?Player?>?Other Settings?>?Allow downloads over HTTP?to something other than?Not allowed.

譯：在2022.1及以上版本的編輯器中，默認情況下禁止使用HTTP下載。為了讓默認的HTTPHostingService正常工作，您需要在Edit > Project Settings… > Player > Other Settings > Allow downloads over HTTP設(shè)置中設(shè)置允許HTTP下載

WARNING

If you reset the port number, you must execute a full application build to generate and embed the correct URL.

譯：如果重置端口號，您必須執(zhí)行完整的應(yīng)用程序構(gòu)建以生成和嵌入正確的URL

NOTE

You may need to disable your local firewall or add exceptions to allow connections from mobile or other devices.

譯：您可能需要禁用本地防火墻或添加例外以允許來自移動設(shè)備或其他設(shè)備的連接

The HTTP Hosting Service is now enabled and ready to serve content from the directory specified in the remote?BuildPath?of each asset group.

譯：HTTP Hosting Service現(xiàn)在已啟用，并準(zhǔn)備從每個資產(chǎn)組的遠程BuildPath指定的目錄中提供內(nèi)容

Hosting Service profile setup

When working with Hosting Services during development, consider creating a profile that configures your asset groups to load from the Hosting Service. For more about profiles, see?Addressable Assets Profiles.

譯：在開發(fā)過程中使用Hosting Services時，考慮創(chuàng)建一個配置資產(chǎn)組從Hosting Service加載的配置文件。有關(guān)配置文件的更多信息，請參見Addressable Assets Profiles

Once in the?Addressables Profiles?window, create a new profile via?Create?>?Profile. In the following example, the new profile is called "Editor Hosted".

譯：一旦進入Addressables Profiles窗口，通過Create > Profile創(chuàng)建一個新的配置文件。在下面的示例中，新配置文件稱為“Editor Hosted”

Modify the remote loading URL to load from the Hosting Service. From the?Addressables Hosting?window, you can use the fields named?[PrivateIpAddress]?and?[HostingServicePort]?in the remote?LoadPath?variable to construct the path URL (for example,?http://[PrivateIpAddress]:[HostingServicePort]).

譯：修改遠程加載URL以從Hosting Service加載。從Addressables Hosting窗口，您可以使用名為[PrivateIpAddress]和[HostingServicePort]的字段在遠程LoadPath變量中構(gòu)建路徑URL（例如，http://[PrivateIpAddress]:[HostingServicePort]）。

Verify that each group is configured correctly. Ensure that you set the?BuildPath?and?LoadPath?paths to their respective profile keys that you modified for use with Hosting Services. In this example, you can see how the profile variables in the?LoadPath?should be expanded to build a correct base URL for loading assets from Hosted Services.

譯：確認每個組都正確配置。確保將BuildPath和LoadPath路徑設(shè)置為用于Hosting Services的各自配置文件鍵。在此示例中，您可以看到LoadPath中的配置文件變量應(yīng)擴展為構(gòu)建從Hosted Services加載資產(chǎn)的正確基本URL

TIP

Use the?Path Preview?to verify that the profile variables resolve to the correct variables. The load path URL IP address and port must match those shown for the service on the?Addressables Hosting?window.

譯：使用路徑預(yù)覽驗證配置文件變量是否解析為正確的變量。加載路徑URL的IP地址和端口必須與Addressables Hosting窗口中顯示的服務(wù)相匹配

Finally, select the new profile from the?Addressables Groups?window, create a build, and deploy to the target device. The Unity Editor now serves all load requests from the application through the?HttpHostingService?service. You can now make additions and changes to content without redeployment. Rebuild the Addressable content, and relaunch the already deployed application to refresh the content.

譯：最后，從Addressables Groups窗口中選擇新配置文件，創(chuàng)建構(gòu)建并將其部署到目標(biāo)設(shè)備。Unity Editor現(xiàn)在通過HttpHostingService服務(wù)為應(yīng)用程序服務(wù)所有加載請求?，F(xiàn)在可以添加和更改內(nèi)容而無需重新部署。重新構(gòu)建Addressable內(nèi)容，并重新啟動已經(jīng)部署的應(yīng)用程序以刷新內(nèi)容

Batch mode

You can also use Hosting Services to serve content from the Unity Editor running in batch mode. To do so, launch Unity from the command line with the following options:

譯：您還可以使用Hosting Services從批處理模式下運行的Unity Editor中提供內(nèi)容。為此，請使用以下選項從命令行啟動Unity：

-batchMode -executeMethod UnityEditor.AddressableAssets.HostingServicesManager.BatchMode

This loads the Hosting Services configuration from the default?AddressableAssetSettings?object, and starts all configured services.

譯：這將從默認的AddressableAssetSettings對象中加載Hosting Services配置，并啟動所有配置的服務(wù)。

To use an alternative?AddressableAssetSettings?configuration, create your own static method entry point, to call through the?HostingServicesManager.BatchMode(AddressableAssetSettings settings)?overload.

譯：要使用替代的AddressableAssetSettings配置，請創(chuàng)建自己的靜態(tài)方法入口點，通過HostingServicesManager.BatchMode(AddressableAssetSettings settings)重載調(diào)用。

Custom services

You can create a custom service to implement your own logic for serving content-loading requests from the Addressable assets system. For example:

譯：您可以創(chuàng)建自定義服務(wù)來實現(xiàn)自己的邏輯，以便從Addressable assets系統(tǒng)中提供內(nèi)容加載請求。例如：

• Support a custom?IResourceProvider?that uses a non-HTTP protocol for downloading content.譯：支持使用非HTTP協(xié)議下載內(nèi)容的自定義IResourceProvider。

• Manage an external process for serving content that matches your production CDN solution (such as an Apache HTTP server).譯：管理用于提供與生產(chǎn)CDN解決方案（如Apache HTTP服務(wù)器）匹配的內(nèi)容的外部進程。

Implementing a custom service

The?HostingServicesManager?can manage any class that implements an?IHostingService?interface (for more details on method parameters and return values, see the?API documentation.

譯：HostingServicesManager可以管理任何實現(xiàn)IHostingService接口的類（有關(guān)方法參數(shù)和返回值的更多詳細信息，請參閱API文檔。

To create a new custom service:

譯：要創(chuàng)建一個新的自定義服務(wù)：

1. Follow the steps outlined in the?configuring a new Hosting Service?section above, but instead of selecting?Create?>?Local Hosting?button, select?Create?>?Custom Service?button instead.譯：按照上面配置新的Hosting Service部分中概述的步驟，但是不要選擇Create > Local Hosting按鈕，而是選擇Create > Custom Service按鈕

2. Drag the applicable script into its field, or select it from the object picker. The dialog validates that the selected script implements the?IHostingService?interface.譯：將適用的腳本拖到其字段中，或者從對象選擇器中選擇它。對話框驗證所選腳本實現(xiàn)IHostingService接口。?

3. To finish adding the service, click the?Add?button.譯：要完成添加服務(wù)，請單擊Add按鈕

Moving forward, your custom service will appear in the?Service Type?drop-down options.

譯：在未來，您的自定義服務(wù)將顯示在Service Type下拉選項中