ucweb_parameter_use

1、 UC瀏覽器開(kāi)放參數(shù)使用說(shuō)明目 錄1 UC瀏覽器客戶(hù)端公共參數(shù)概述21.1 客戶(hù)端公共參數(shù)的作用21.2 UC瀏覽器開(kāi)放參數(shù)說(shuō)明21.3 客戶(hù)端公共參數(shù)詳細(xì)說(shuō)明32 開(kāi)放參數(shù)獲取方式73 常見(jiàn)問(wèn)題以及說(shuō)明83.1 UC瀏覽器直連和中轉(zhuǎn)兩種訪問(wèn)方式有何異同？83.2 直連/中轉(zhuǎn)方式對(duì)獲取公共參數(shù)的限制93.3 302跳轉(zhuǎn)不支持公共參數(shù)傳遞的處理方法91 UC瀏覽器客戶(hù)端公共參數(shù)概述1.1 客戶(hù)端公共參數(shù)的作用Web/Wap應(yīng)用通過(guò)URL傳遞參數(shù)的方式向UC瀏覽器按需獲取需要的信息。開(kāi)放參數(shù)信息可以快捷的幫助Web/Wap應(yīng)用對(duì)UC瀏覽器適配。通過(guò)獲取分辨率、平臺(tái)、聯(lián)網(wǎng)方式等信息進(jìn)行優(yōu)化，給用戶(hù)提

2、供更好移動(dòng)互聯(lián)網(wǎng)訪問(wèn)體驗(yàn)。1.2 UC瀏覽器開(kāi)放參數(shù)說(shuō)明UC瀏覽器公共參數(shù)面向所有合法WEB/WAP應(yīng)用開(kāi)放。合法WEB/WAP應(yīng)用可以根據(jù)UC瀏覽器公共參數(shù)獲取協(xié)議按需獲取公共參數(shù)。值得注意的是：有些開(kāi)放參數(shù)只是在特定版本中可獲取，較低版本的UC瀏覽器可能存在不能獲取公參的情況。以下為公共參數(shù)的數(shù)據(jù)字典及與UC瀏覽器版本的對(duì)應(yīng)關(guān)系：序號(hào)客戶(hù)端參數(shù)參數(shù)描述適用UC瀏覽器版本1up手機(jī)品牌、系統(tǒng)參數(shù)7.8版本及以上2ss手機(jī)分辨率參數(shù)7.8版本及以上3nt客戶(hù)端聯(lián)網(wǎng)方式參數(shù)7.2版本及以上4dn客戶(hù)端序列號(hào)7.2版本及以上5ve客戶(hù)端版本號(hào)7.2版本及以上6la客戶(hù)端語(yǔ)言環(huán)境7.7版本及以上7m

3、i客戶(hù)端UA7.8版本及以上1.3 客戶(hù)端公共參數(shù)詳細(xì)說(shuō)明1.3.1 up參數(shù)描述：up參數(shù)是指UC瀏覽器客戶(hù)端安裝手機(jī)的機(jī)型屬性。機(jī)型屬性包括：手機(jī)的品牌、手機(jī)機(jī)型、手機(jī)平臺(tái)、手機(jī)系列。參數(shù)傳輸時(shí)，進(jìn)行urlencode編碼。用途舉例：針對(duì)手機(jī)機(jī)型的軟件下載。格式：采用結(jié)構(gòu)化的字符串表示手機(jī)的品牌、手機(jī)機(jī)型、手機(jī)平臺(tái)、手機(jī)系列，字符串的采用Key:Value;Key:Value;的形式。如用戶(hù)使用的手機(jī)為Nokia5800，則具體結(jié)構(gòu)為：s:S60V5|f:sis|m:5800|b:Nokia其中：s：對(duì)應(yīng)的值是手機(jī)系列。如S60V3。f：對(duì)應(yīng)的值是手機(jī)平臺(tái)。如sis，表示Symbian平臺(tái)

4、。 m：對(duì)應(yīng)的值是手機(jī)機(jī)型。如5800。b：對(duì)應(yīng)的值是手機(jī)品牌。如Nokia。1.3.2 ss參數(shù)描述：ss是指安裝UC瀏覽器的手機(jī)的屏幕參數(shù)，即屏幕的寬和高，單位為像素。用途舉例：Web/Wap通過(guò)獲取ss參數(shù)拿到用戶(hù)手機(jī)分辨率信息后，可以根據(jù)用戶(hù)屏幕特點(diǎn)，進(jìn)行定制的網(wǎng)頁(yè)適配以獲得最佳的現(xiàn)實(shí)效果。游戲類(lèi)網(wǎng)站也可以通過(guò)ss參數(shù)給用戶(hù)適配合適用戶(hù)手機(jī)屏幕分辨率的相應(yīng)游戲。格式：采用寬度x高度的方式，例如：320x2401.3.3 nt參數(shù)描述：nt指的是用戶(hù)使用UC瀏覽器訪問(wèn)互聯(lián)網(wǎng)的聯(lián)網(wǎng)形式。包括wap訪問(wèn)、net訪問(wèn)、wifi訪問(wèn)。用途舉例對(duì)于下載或耗費(fèi)流量較大的WEB/WAP應(yīng)用，通過(guò)獲取n

5、t參數(shù)，可以有針對(duì)性的給用戶(hù)提供最適應(yīng)資源。若收到nt值為2，表示用戶(hù)使用wifi上網(wǎng)，那么可以考慮適當(dāng)?shù)耐扑透哔|(zhì)量的資源給用戶(hù)。格式：采用數(shù)字代表聯(lián)網(wǎng)方式：代號(hào)聯(lián)網(wǎng)方式0 wap1 net2 wifi99 缺省1.3.4 dn參數(shù)描述：dn指的是客戶(hù)端安裝序列號(hào)，為用戶(hù)的手機(jī)安裝UC瀏覽器后由瀏覽器云端隨機(jī)生成的一個(gè)字符串。每一個(gè)手機(jī)上的UC瀏覽器客戶(hù)端都擁有唯一的dn值。當(dāng)用戶(hù)卸載UC瀏覽器后再執(zhí)行安裝UC瀏覽器的操作，dn值將再次隨機(jī)生成。用途舉例：在非強(qiáng)制注冊(cè)的Web/Wap應(yīng)用中，可以用dn做為用戶(hù)標(biāo)記參數(shù)。因?yàn)閐n具有唯一性，故閱讀類(lèi)網(wǎng)站可以用于記錄用戶(hù)歷史閱讀記錄、視頻類(lèi)網(wǎng)站可以

6、用于記錄觀看歷史。格式：例如1234567-abcdefg1.3.5 ve參數(shù)描述：ve指的是UC瀏覽器客戶(hù)端版本號(hào)。用于識(shí)別用戶(hù)使用UC瀏覽器的版本號(hào)信息。用途舉例：UC瀏覽器7.7及以上版本支持支付寶在線快捷支付。有移動(dòng)互聯(lián)網(wǎng)支付需求的WEB/WAP應(yīng)用可以根據(jù)用戶(hù)的版本號(hào)進(jìn)行支付流程的個(gè)性化定制。格式：例如5。1.3.6 la參數(shù)描述： la是指UC瀏覽器的使用語(yǔ)言環(huán)境。用途舉例：有國(guó)際化需求的Web/Wap應(yīng)用可以根據(jù)從UC瀏覽器獲取的la的屬性，推送相應(yīng)國(guó)家語(yǔ)言的頁(yè)面給用戶(hù)。格式：采用國(guó)際標(biāo)準(zhǔn)的語(yǔ)言的英文縮寫(xiě)形式，例如：zh-cn：Chinese - Peoples R

7、epublic of Chinazh-sg：Chinese Singaporezh-tw：Chinese - Taiwanzh-hk：Chinese - Hong Kong SARzh-mo：Chinese - Macao SARen-us：English - United Statesen-gb：English - United Kingdomen-au：English - Australiaen-bz：English - Belizeen-ca：English Canada1.3.7 mi參數(shù)描述：mi是手機(jī)的UA字符串信息，包含用戶(hù)手機(jī)完整的UA信息。參數(shù)傳輸時(shí)，使用urlencode編

8、碼用途舉例：mi包含用戶(hù)手機(jī)的原始UA信息，可供Web/Wap應(yīng)用獲取原始數(shù)據(jù)，做更深層次的用戶(hù)數(shù)據(jù)分析。格式：與標(biāo)準(zhǔn)的瀏覽器UA相同。2 開(kāi)放參數(shù)獲取方式Web/Wap應(yīng)用在網(wǎng)頁(yè)URL中包含申請(qǐng)UC瀏覽器公參請(qǐng)求字符串：uc_param_str如：UC瀏覽器接收到公參申請(qǐng)請(qǐng)求后返回相應(yīng)數(shù)據(jù)如： s:S60V5|f:sis|m:5800|b:Nokia說(shuō)明：1) uc_param_str字符串位于url的參數(shù)部分，uc_param_str的值指明了需要返回的開(kāi)放參數(shù)。2) uc_param_str采用固定位的格式，每?jī)蓚€(gè)字節(jié)表示一個(gè)參數(shù)，例如：uc_param_str=dnup表示要獲取dn（

9、瀏覽器安裝序列號(hào)）和up（手機(jī)機(jī)型信息）3) uc_param_str應(yīng)該是全小寫(xiě)。具體的標(biāo)識(shí)串是“uc_param_str=”。客戶(hù)端只對(duì)url查找“uc_param_str=”字符串作為是否進(jìn)行參數(shù)判的條件。值判斷是從=開(kāi)始，遇到&或#結(jié)束（或者是整個(gè)url結(jié)束）。3 常見(jiàn)問(wèn)題以及說(shuō)明3.1 UC瀏覽器直連和中轉(zhuǎn)兩種訪問(wèn)方式有何異同？3.1.1 直連訪問(wèn)方式直連訪問(wèn)方式的定義：UC瀏覽器客戶(hù)端直接訪問(wèn)目標(biāo)網(wǎng)頁(yè)所在的服務(wù)器，讀取原始網(wǎng)頁(yè)代碼，在客戶(hù)端進(jìn)行解析。直連訪問(wèn)的適用范圍：通常是一些WAP網(wǎng)站，這些WAP網(wǎng)站一般是面向手機(jī)客戶(hù)端而設(shè)計(jì)，其數(shù)據(jù)量以及格式方便客戶(hù)端直接解析，因此WAP網(wǎng)站

10、通常采用直連訪問(wèn)方式。UC瀏覽器目前已支持XHTML網(wǎng)站。3.1.2 中轉(zhuǎn)訪問(wèn)方式中轉(zhuǎn)訪問(wèn)方式的定義：當(dāng)用戶(hù)使用UC瀏覽器訪問(wèn)HTML格式的WEB應(yīng)用時(shí)，考慮到當(dāng)前終端處理能力、無(wú)線網(wǎng)絡(luò)帶寬、運(yùn)營(yíng)商流量資費(fèi)等限制，有必要通過(guò)中間件進(jìn)行優(yōu)化處理，為手機(jī)終端提供更快、更好的瀏覽體驗(yàn)。中轉(zhuǎn)訪問(wèn)方式的適用范圍：通常是一些WEB網(wǎng)站（一般稱(chēng)WWW網(wǎng)站），這些WEB網(wǎng)站一般是面向PC客戶(hù)端而設(shè)計(jì)，數(shù)據(jù)量以及格式不方便客戶(hù)端直接解析給用戶(hù)使用，因此需要UC的中間件服務(wù)器機(jī)型處理，采用中轉(zhuǎn)訪問(wèn)方式。3.2 直連/中轉(zhuǎn)方式對(duì)獲取公共參數(shù)的限制通過(guò)中轉(zhuǎn)方式訪問(wèn)，在以下場(chǎng)景時(shí)不支持公共參數(shù)傳遞：n 通過(guò)圖片請(qǐng)求UC瀏覽器公共參數(shù)n 通過(guò)css請(qǐng)求請(qǐng)求UC瀏覽器公共參數(shù)n 通過(guò)302跳轉(zhuǎn)請(qǐng)求請(qǐng)求UC瀏覽器公共參數(shù)n 通過(guò)refresh請(qǐng)求請(qǐng)求UC瀏覽器公共參數(shù)通過(guò)直連方式不受以上限制。