備註
Dynamics 365 Commerce 的零售興趣群組已從 Yammer 移至 Viva Engage。 如果您無法存取新的Viva Engage社群，請填寫此表單 （https://aka.ms/JoinD365commerceVivaEngageCommunity） 以新增，並繼續參與最新的討論。
本文介紹媒體庫模組，並說明如何在 Microsoft Dynamics 365 Commerce 中將它們新增到網站頁面。
媒體庫模組在資源庫檢視中會顯示一或多個圖像。 媒體庫模組支援縮圖，縮圖可以水平排列 (作為圖像下方的一列) 或垂直排列 (作為圖像旁邊的行)。 媒體庫模組還提供使圖像能夠縮小 (放大) 或以全螢幕模式查看的功能。 若要在媒體庫模組中呈現，圖像必須在 Commerce 網站建立器媒體庫中可用。 目前，媒體庫模組僅支援圖像。
在預設模式下，媒體庫模組使用產品詳細資訊頁面 (PDP) 的頁面上下文中所提供的產品識別碼來呈現相應的產品圖像。 在 Commerce headquarters 中，必須為所有產品定義媒體檔案路徑。 然後，應根據在 Commerce headquarters 中為產品定義的檔案路徑，將圖像上傳到網站建立器媒體庫。 這些圖像包括產品和任何產品變型的圖像。 有關如何將圖像上傳到網站建立器媒體庫的詳細資訊，請參閱上傳圖像。
或者，媒體庫模組可以在圖像庫頁面上託管一組完全精選的圖像，其中不依賴於產品識別碼或頁面上下文。 在這種情況下，圖像必須上傳到網站建立器媒體庫並在網站建立器中指定。
以下是媒體庫模組的一些使用範例：
- 在 PDP 上呈現產品圖像
- 在產品行銷頁面上呈現產品圖像
- 在行銷頁面 (如資源庫頁面) 上展示一組精選圖像
在下圖的範例中，PDP 上的購買方塊使用媒體圖庫模組來託管產品圖像。
媒體庫屬性
| 屬性名稱 | 值 | 說明 |
|---|---|---|
| 圖像來源 | 頁面上下文或產品識別碼 | 預設值為頁面上下文。 如果選取了 頁面上下文，則模組預期頁面會提供產品識別碼資訊。 如果選取了產品識別碼，則必須提供圖像的產品識別碼作為產品識別碼屬性的值。 此功能在 Commerce 版本 10.0.12 中提供。 |
| 產品識別碼 | 產品識別碼 | 僅當圖像來源屬性的值為產品識別碼時，此屬性才適用。 |
| 圖像縮放 | 內嵌或容器 | 此屬性允許使用者縮放媒體庫模組中的圖像。 圖像可以內嵌縮放，也可以在圖像旁邊的單獨容器中縮放。 此功能在版本 10.0.12 中提供。 |
| 縮放係數 | 小數點數字 | 此屬性指定縮放圖像的比例係數。 例如，如果該值設定為 2.5，則圖像將放大 2.5 倍。 |
| 全螢幕 | True 或 False | 此屬性指定是否可以在全螢幕模式下查看圖像。 在全螢幕模式下，如果打開縮放功能，圖像也可以進一步放大。 此功能在 Commerce 10.0.13 發行版本中提供。 |
| 縮放圖像品質 | 一個介於 1 到 100 之間的數字，表示百分比，並使用滑桿控制項進行選取 | 此屬性定義縮小圖像的圖像品質。 可以將其設定為 100%，以確保縮小的圖像永遠盡使用最高可能解析度。 此屬性不適用於 PNG 檔案，因為它們使用無損格式。 此功能自 Commerce 10.0.19 發行版本起開始提供。 |
| 圖像 | 從網站建立器媒體庫中選取的圖像 | 除了從產品呈現之外，還可以為圖庫模組精選圖像。 這些圖像將附加到任何可用的產品圖像之後。 此功能在 Commerce 版本 10.0.12 中提供。 |
| 縮圖方向 | 垂直或水平 | 此屬性指定縮圖的圖像應以直條還是橫條顯示。 |
| 隱藏產品變型的基準產品影響 | True 或 False | 如果此屬性設定為 True，則在選取變型時，將隱藏主產品的圖像，除非該變型沒有圖像。 此屬性不會影響沒有變型的產品。 |
| 選取維度時更新媒體 | True 或 False | 如果此屬性設定為 True，則在選取任何維度 (如顏色、樣式或大小) 且圖像可用時，將更新媒體庫中的圖像。 此屬性有助於簡化瀏覽體驗，因為並非一定要選取每個產品變型維度才能更新相應的圖像。 此屬性可在進階索引標籤上找到。 |
重要
維度選取上的更新媒體屬性自 Commerce 版本 10.0.21 發行版本開始提供。 它要求安裝 Commerce 模組庫套裝版本 9.31。
下圖顯示提供全螢幕和縮放選項的媒體庫模組範例。
下圖顯示具有精選圖像的媒體庫模組範例 (即，指定的圖像不依賴產品識別碼或頁面上下文)。
Commerce Scale Unit 互動
當圖像來源衍生自頁面上下文時，會使用產品詳細資訊頁面 (PDP) 中的產品識別碼來檢索圖像。 媒體庫模組使用 Commerce Scale Unit 應用程式介面 (API) 來檢索產品的圖像檔案路徑。 然後從媒體庫中擷取圖像，以便在模組中呈現。
將媒體庫模組新增到頁面
要在行銷頁面新增媒體圖庫模組，請遵循以下步驟：
- 移至範本，然後選取新以建立新的範本。
- 在新範本對話方塊中，在範本名稱底下，輸入行銷範本，然後選取確定。
- 在本文位置中，選取省略符號 (...)，然後選取新增模組。
- 在選取模組對話方塊中，選取預設頁面模組，然後選取確定。
- 在預設頁面的主要插槽中，選取省略符號 (...)，然後選取新增模組。
- 在選取模組對話方塊中，選取容器模組，然後選取確定。
- 選取儲存，選取完成編輯以簽入範本，然後選取發佈以進行發佈。
- 移至頁面，然後選取新以建立新的頁面。
- 在建立新頁面對話方塊的頁面名稱底下，輸入媒體庫頁面，然後選取下一步。
- 在選擇範本底下，選取您建立的行銷範本，然後選取下一步。
- 在選擇版面配置底下，選取頁面版面配置 (例如，彈性版面配置)，然後選取下一步。
- 在檢閱和完成底下，檢閱頁面設定。 如果您需要編輯頁面資訊，請選取返回。 如果頁面資訊正確，則選取建立頁面。
- 在新頁面的主要位置中，選取省略符號 (...)，然後選取新增模組。
- 在選取模組對話方塊中，選取容器模組，然後選取確定。
- 在容器位置中，選取省略符號 (...)，然後選取新增模組。
- 在選取模組對話方塊中，選取媒體庫模組，然後選取確定。
- 在媒體庫模組的屬性窗格中，在圖像來源底下，選取 Productid。 然後，在產品識別碼欄位中，輸入產品識別碼。
- 選取儲存，然後選取預覽以預覽頁面。 您應該能夠在資源庫檢視中看到產品的圖像。
- 若要僅使用精選圖像，請在屬性窗格中的圖像來源底下，選取 Productid。 然後，在圖像底下，根據需要多次選取新增圖像以新增來自媒體庫的圖像。
- 設定要設定的任何其他屬性，例如圖像縮放、縮放係數和縮圖方向。
- 完成後，選取儲存，選取完成編輯以簽入頁面，然後選取發佈來發佈它。