物件ID轉換

「影像伺服」提供將外部物件ID轉譯為地區設定特定物件(目錄)ID的機制。 主要應用程式是提供地區特定的內容和在多個地區之間共用的內容,而用戶端應用程式則不需要知道地區特定的物件ID。

只能使用全域物件ID來編寫應用程式,而影像伺服功能會自動取代地區設定特定的影像和其他可用內容。

locale​在「影像伺服」請求中使用locale=命令指定。

注意

物件ID轉譯僅適用於以目錄為基礎的影像伺服。 無法翻譯檔案名。

範圍

所有對影像、SVG和靜態內容目錄中項目的參考都會視為翻譯字型,而ICC描述檔參考則不會翻譯。 除了/is/image和/is/static requests路徑中的​object​外,這些命令和目錄屬性還受ID轉換的約束:src=mask=template=defaultImage=attribute::DefaultImageattribute::Watermark

ID轉換映射

attribute::LocaleMap 定義伺服器用來判斷本地化內容ID的規則,以輸入一般物件ID和 locale= 值。

attribute::LocaleMap 包含輸入地區設定 清單 (與指定的值相符 locale=),每個地區都包含無或多個輸出地區設定字尾( *locSuffix*)。

例如,attribute::LocaleMap可能如下所示:

en,_E,|en_us,_E,|en_uk,_E,|fr,_F,|de,_D,|de_at,_D,|de_de,_D,|,_E,

請求/is/image/myCat/myImg?locale=de_de會傳回與目錄條目myCat/myImg_D相關聯的影像(假設存在此類目錄條目)。

有關詳細資訊,請參閱attribute::LocaleMap的說明。

翻譯過程

在上述範例中,伺服器會先在ID轉換映射中尋找​locale " de_de"。 然後,它會重複與此條目關聯的​locSuffixes,在本例中為" _D"和""(空尾碼)。 對於每個迭代,尾碼會附加到影像ID和測試在目錄中存在的結果ID。 如果找到,則使用該目錄條目,否則將測試下一個條目。 在此示例中,會檢查以下條目:myCat/myImg_DmyCat/myImg。 如果找不到相符項目,伺服器會傳回錯誤或預設影像(如果已設定)。

未知地區設定

在上例中,attribute::LocaleMap包含一個空的​locale,它定義了預設轉換規則,用於未知的locale=值(即未在轉換映射中明確列出的值)。 如果此轉換映射應用於請求/is/image/myCat/myImg?locale=ja,則它將解析為myCat/myImg_E(如果存在),否則將解析為myCat/myImg

如果轉換映射未指定預設轉換規則,則對於具有未知locale=值的所有請求都將返回錯誤。

範例

多層次查閱

通常最好將地區(例如歐洲、中東、北美)分組,以符合地區標準。 這可透過多層次查閱來達成。

在此範例中,我們想支援西部和中東使用的系列。 這兩個集合都以通用影像集合為基礎,增加或修改了一些影像。然後,這兩個系列會針對特定地區(m1m2(針對兩個中東地區變數)進一步調整,以及w1w2w3(針對三個西方地區設定),但影像會共用給w1w3。 不明地區只會對應至通用集合,且無權存取地區特定影像。

attribute::LocaleMap: w1,-W,|w2,-W2,-W,|w3,-W,|m1,-M1,-M,|m2,-M2,-M,|,

下表說明了將考慮哪些目錄條目,以及它們被視為通用輸入ID myImg的順序:

地區設定 要搜尋的目錄ID

w1, w3

myImg-W, myImg

w2

myImg-W2, myImg-W, myImg

m1

myImg-M1, myImg-M, myImg

m2

myImg-M2, myImg-M, myImg

所有其他

myImg

搜尋特定ID

某些影像命名慣例可能不支援內部的一般影像ID。 請求的通用ID必須一律對應至目錄中的特定ID;通常,可能不知道確切的特定ID。

在此範例中,所有語言的影像可能有_1_2_3字尾。 法文地區的特定影像可能有_22_23字尾,而德文地區的特定影像可能有_470_480字尾。

attribute::LocaleMap: ,_1,_2,_3|fr,_22,_23,_1,_2,_3|de,_470,_480,_1,_2,_3| de_at,_470,_480,_1,_2,_3| de_de,_470,_480,_1,_2,_3

下表說明了哪些目錄條目被考慮,以及它們被視為通用輸入ID myImg的順序:

地區設定 要搜尋的輸出ID

fr

myImg_22, myImg_23, myImg_1, myImg_2,myImg_3

de , de_at , de_de

myImg_470, myImg_480, myImg_1, myImg_2,myImg_3

所有其他

myImg_1, myImg_2, myImg_3

另請參閱

attribute::LocaleMap , attribute::DefaultLocale, locale=, req=xlate

本頁內容

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free