2. Android接入

接入SDK

1. 下載官網最新 SDK 包 didi_sdk_v2.1.xxxx.aar
2. 打開 Android Studio
3. 將 aar 拷貝至接入工程 libs 目錄
4. 在接入工程 build.gradle 中配置 aar 加載目錄 repositories { flatDir { dirs 'libs' } }
5. 在接入工程 dependencies 中添加SDK 的 aar 依賴 dependencies { compile(name: 'didi_sdk_v2.1.xxxx', ext: 'aar') }

注： SDK中包 so 動態庫，支持主流 cpu 架構，目前所有支持的ABI有：armeabi、armeabi-v7a、arm64-v8a、x86 ，為減少 SDK 體積，aar 中默認值包含 armeabi-v7a 架構 so，有需要其他架構 so 的用戶，請自行從官網下載 SDK so 集合，將相應的架構 so 復制到接入工程 libs 目錄下。

使用滴滴服務

注意 由于滴滴的服務依賴于定位，如果您沒有主動傳入定位信息則滴滴開放平臺會自動定位，由于系統定位精度差定位速度慢，推薦您接入了第三方定位SDK。

在傳入已有坐標時對應的maptype參數如下表：

需要傳參數的的Map的key，value都為String,返回值都為Map的key，value都為String,在返回的Map中包含errorno和errormsg，其中errorno為判斷返回是否成功的標志，返回0為成功，具體返回值的含義需要根據服務器接口對應文檔獲取。

1.在入口Activity中調用

DIOpenSDK.registerApp(context,"appid","secret")

// appid和 secret 需要向開放平臺申請

DIOpenSDK.setMapSdkType(DIOpenSDK.MapLocationType.*)(可選)

應在調用其他滴滴方法之前調用

2.直接調用打車業務

DIOpenSDK.showDDPage(Context,HashMap<String,String>);

Context參數盡量傳Activity 其中HashMap為需要傳給滴滴開放平臺的參數

3.使用滴滴openapi直接調用滴滴接口

在申請appid和secret時，可以同時申請通過滴滴開放平臺sdk直接調用滴滴服務器相應接口（需要經過商務協商）或者直接通過服務器和開放平臺服務器直接對接。

服務器和服務器對接：

通過在主線程中調用DIOpenSDK.asynGetTicket(Context context, TicketType typeContext context, TicketType type, DDCallBack callBack)或者在分線程中調用DIOpenSDK.syncGetTicket()獲取ticket，回傳到第三方服務器用來服務器和服務器對接。

直接調用滴滴服務器API

通過在分線程中調用DIOpenSDK.syncCallDDApi(Context context, String apiname, Map<String, String> params)或者在主線程中調用DIOpenSDK.asynCallDDApi(Context context, String apiname, Map<String, String> requestParams, DDCallBack callBack) 即可調用滴滴服務器api具體可以調用的API列表需要跟商務確認。

直接調用滴滴功能頁面

通過直接在主線程中調用DIOpenSDK.openPage(Context context,String page, Map<String, String> extra)即可打開滴滴提供的指定的功能性頁面，比如登錄、訂單列表等，如果調用成功返回true調用失敗返回false。

調用滴滴司機電話

當您調用滴滴相應功能獲取到司機的加密手機號后需要使用DIOpenSDK.callPhone(Context context, String phone)來撥打司機電話。

配置界面UI

SDK提供了自定義界面UI的接口，通過 DIOpenSDK.setUIOptions 設置 UI 參數：

    UIOptions uiOptions = new UIOptions();



    uiOptions.setCloseEnable(true); //設置是否顯示關閉按鈕

    uiOptions.setProgressBarEnable(false);//設置進度條是否顯示

    uiOptions.setProgressBarStyle(R.style.Widget_AppCompat_ProgressBar);//設置進度條樣式

    uiOptions.setBackButtonTextColor(Color.RED);//設置返回按鈕文字顏色

    uiOptions.setCloseButtonTextColor(Color.BLACK);//設置關閉按鈕文字顏色

    uiOptions.setTitleTextColor(Color.YELLOW);//設置標題的文字顏色

    uiOptions.setTitleBarBackgroundResource(R.color.holo_blue_bright);//設置標題欄背景



    DIOpenSDK.setUIOptions(uiOptions);//設置UI參數

ReleaseNote

• v2.1
  • 升級 openssl 庫到 v1.1
  • 解決多個安全漏洞
  • 支持自定義UI

3. IOS

1 主功能配置

SDK依賴于微信支付，需要拉起微信，所以主工程中的plist中需要添加微信的schema。 framework需要使用定位權限，其中定位的提示文案可以自己設置。 工程Build Settings里Other Linker Flags需要添加 ObjC 項，以確保 .framework 里的類別能加載上

2 SDK注冊

App啟動后需要使用滴滴開發者中心申請的appid和secret注冊SDK，調用方法如下：

[DIOpenSDK registerApp:@"your appId" secret:@"your secret"];

3 調起打車頁面

/** 

 * 通過該方法調起滴滴頁面

 * @param parentController 需要調起叫車頁面的controller 

 * @param animated 展現滴滴頁面時是否需要動畫 

 * @param optionParams 打開打車頁面的可選參數，參數列表可以參見【參數列表】欄目 

 * @param delegate 擴展參數，后續用于SDK和app進行一些交互 

 */ 

(void)showDDPage:(UIViewController *)parentController 

    animated:(BOOL)animated 

    params:(DIOpenSDKRegisterOptions *)optionParams 

    delegate:(id<DIOpenSDKDelegate>)delegate;

4. 常見問題

Q：如何找到百度網訊科技API

A：冪簡集成是國內領先的API集成管理平臺，專注于為開發者提供全面、高效、易用的API集成解決方案。冪簡API平臺可以通過以下兩種方式找到所需API：通過關鍵詞搜索API(例如，輸入’百度網訊科技API‘這類品類詞，更容易找到結果)、或者從API hub分類頁進入尋找。

Q：語音識別結果與音頻內容不匹配
A：

• 語音識別返回結果與音頻內容不匹配，例如：“嗨嗨嗨”、“嗯嗯嗯嗯嗯”、“什么”等錯誤返回。
• 解決方法：排查音頻采樣率、聲道、格式等參數是否符合接口規范。如與要求不符，需要用工具對音頻進行轉碼，轉碼工具跳轉。

Q：3300錯誤碼怎么辦？
A：

• 語音識別api使用的是HTTP POST方法， BODY里直接放置json， Content-Type頭部為 application/json。 并非常見的瀏覽器表單請求（application/x-www-form-urlencoded或者multipart/x-www-form-urlencoded）。
• 必填字段：format rate channel cuid token cuid token cuid token cuid token，請勿漏填。此外 (speech, len) 及 (url, callback) 這兩組參數必須二選一，如果都填，默認處理第一組。
• 必填字段如format rate channel cuid token，請勿漏填。此外 (speech, len) 及 (url, callback) 這兩組參數必須二選一，如果都填，默認處理第一種，并確認音頻時長截取為60s以下。

Q：3309錯誤碼怎么辦？
A：wav和amr的音頻，服務端會自動轉為pcm，這個過程中導致轉碼出錯。請確認下format及rate參數與音頻一致，并確認音頻時長截取為60s以下。

Q：3301錯誤碼怎么辦？
A：

• 識別結果實際為空。可能是音頻質量過差，不清晰，或者是空白音頻。
• 有時也可能是pcm填錯采樣率。如16K采樣率的pcm文件，填寫的rate參數為8000。

Q：行業與場景限制

A：根據工信部《綜合整治騷擾電話專項行動方案》、《關于推進綜合整治騷擾電話專項行動的工作方案》，相關能力不得用于商業營銷類、惡意騷擾類和違法犯罪類騷擾電話類場景，也不支持在貸款、理財、信用卡、股票、基金、債券、保險、售房租房、醫療機構、保健食品、人力資源服務、旅游等場景的騷擾電話營銷行為。

Q：百度網訊科技API的替代品有哪些？

提供AI大模型API的服務商除了百度網訊科技API，還有其他替代服務商也提供類似api服務，例如：

Astronomer API開放平臺、OpenAI API開放平臺、goperigon API開放平臺

更多競品可以在冪簡集成開放平臺中找到。

Q：百度網訊科技API這個密鑰還適用于哪些api？

獲取接入方用戶信息、線下測試環境司機自動化接單、機場信息接口

5.  總結

本文“如何獲取滴滴AI開放平臺訪問密鑰分步指南”為開發者們精心打造了一份全面、詳盡且實用的操作指南。從滴滴AI開放平臺賬號的注冊，到開發者身份的認證，再到最終成功獲取訪問密鑰，每一步操作都進行了細致入微的介紹，并配以詳盡的說明和指導，確保開發者能夠輕松、順利地完成整個流程。我們深知，獲取訪問密鑰只是利用滴滴AI開放平臺資源的開始。因此，本文還特別強調了獲取密鑰后應進行可用性測試的重要性，這是確保AI服務能夠順利集成到應用中并發揮最佳效果的關鍵一步。本文為開發者們提供了一份寶貴的資源，幫助他們成功接入滴滴AI開放平臺，將前沿的AI技術轉化為實際應用的價值，進一步提升應用的智能化水平和用戶體驗。我們相信，通過本文的指導，開發者們將能夠更加高效、便捷地利用滴滴AI開放平臺的資源，推動業務的創新與發展。