：資料結構

屬性名稱

類型

描述

audioProfile

ARTCAICallAudioProfile

音頻編碼配置，預設是 HighQualityMode

audioScenario

ARTCAICallAudioScenario

音頻情境配置，預設是 ARTCAICallAudioSceneMusicMode

屬性名稱

類型

描述

view

UIView

渲染視圖

viewMode

ARTCAICallAgentViewMode

畫面渲染模式

viewMirrorMode

ARTCAICallAgentViewMirrorMode

畫面鏡像模式

viewRotationMode

ARTCAICallAgentViewRotationMode

畫面旋轉模式

屬性名稱

類型

描述

preview

UIView?

預覽，為空白表示不預覽只推流

viewMode

ARTCAICallAgentViewMode

預覽畫面渲染模式

viewMirrorMode

ARTCAICallAgentViewMirrorMode

預覽畫面鏡像模式

viewRotationMode

ARTCAICallAgentViewRotationMode

預覽畫面旋轉模式

dimensions

CGSize

推流解析度

frameRate

Int

推流幀率

bitrate

Int

推流碼率

keyFrameInterval

Int

推流主要畫面格間隔（毫秒）

useHighQualityPreview

Bool

是否使用高清預覽，否則 SDK 自動調整

cameraCaptureFrameRate

Int

預覽解析度（預設為 15fps）

屬性名稱

類型

描述

text

String

請求多模態大模型時的文本參數

enableASR

Bool

是否將 ASR 結果作為輸入傳給大模型

isSingle

Bool

是否為單次截幀

eachDuration

UInt

截幀間隔時間長度（秒）

num

UInt

每次截幀的圖片數量

duration

UInt

持續截幀的時間長度（秒），僅在持續截幀時生效

userData

String?

JSON 字串，自訂商務資訊

屬性名稱

類型

描述

text

String

詢問智能體的簡訊，例如："這是什嗎？"

屬性名稱

類型

描述

agentId

String

智能體 ID

agentType

ARTCAICallAgentType

智能體類型，必須是agentId的類型，否則啟動智能體會報錯

agentUserId

String?

智能體的 Uid，為空白時由服務分配

region

String

智能體服務所在地區，必須是agentId所在的地區，否則啟動智能體會報錯

userId

String

目前使用者 ID

userJoinToken

String

目前使用者的入會 Token

userData

[String: Any]?

使用者自訂資訊，最終傳給智能體

agentConfig

ARTCAICallAgentConfig?

用於啟動通話的agentConfig參數

audioConfig

ARTCAICallAudioConfig?

本地音頻配置

videoConfig

ARTCAICallVideoConfig?

本地視頻配置，VisionAgent/VideoAgent時才會生效

chatSyncConfig

ARTCAICallChatSyncConfig?

關聯的 chat 智能體配置

templateConfig

ARTCAICallTemplateConfig（棄用）?

已棄用，請使用 agentConfig

屬性名稱

類型

描述

agentGreeting

String?

智能體歡迎語，為空白表示使用智能體配置值，最大長度100字元

userOnlineTimeout

Int32

使用者未入會，智能體逾時關閉任務的時間，小於0則使用服務端預設值 60s

userOfflineTimeout

Int32

使用者退會後，智能體逾時關閉任務的時間，小於0則使用服務端預設值 5s

workflowOverrideParams

[String: Any]?

工作流程覆蓋參數

bailianAppParams

[String: Any]?

百鍊應用中心參數

asrMaxSilence

Int32

語音斷句檢測閾值，範圍 200ms～1200ms，小於0使用服務端預設值 400ms

volume

Int32

智能體說話的音量，範圍 0~400，輸出音量 = 工作流程中的語音輸出音量 * volume / 100，小於0使用服務端預設值 100

vadLevel

Int32

設定AIVad的靈敏度參數，預設值為3，取值範圍：[0,10]

enableVoiceInterrupt

Bool

是否開啟智能打斷

agentVoiceId

String?

智能體講話音色 ID，為空白表示使用智能體配置值

enableIntelligentSegment

Bool

是否開啟智能斷句合并

useVoiceprint

Bool

當前斷句是否使用聲紋降噪識別

voiceprintId

String?

聲紋 ID，如果不為空白表示當前通話開啟聲紋降噪能力

agentMaxIdleTime

Int32

智能體閑時的最大等待時間（單位：秒），小於0使用服務端預設值 600s

llmHistoryLimit

Int32

LLM/Multimodal LLM 歷史對話上下文最大保留輪次，小於0使用服務端預設值 10

enablePushToTalk

Bool

是否開啟對講機模式

agentGracefulShutdown

Bool

是否優雅下線：播報完當前句子再停止

agentAvatarId

String?

數字人模型 ID，為空白表示使用智能體配置值

asrLanguageId

String?

ASR 語種 ID，為空白表示使用智能體配置值，可選：

• zh_mandarin 中文

• en 英文

• zh_en 中英混

• es 西班牙語

• jp 日語

wakeUpQuery

String?

使用者在通話啟動前的指令，用於智能體在通話啟動後立即響應

llmSystemPrompt

String?

LLM 系統提示詞，例如：“你是一位友好且樂於助人的助手...” 注意：不支援 LLM 節點為百鍊工作流程類型

asrHotWords

[String]?

ASR熱詞列表，限制：500個詞及以內，每個詞不超過10個字元

interruptWords

[String]?

觸發對話打斷的特定詞彙或短語，例如：“打斷一下”、“我知道了”

屬性名稱

類型

描述

sessionId

String

關聯的 chat 智能體會話 ID

agentId

String

關聯的 chat 智能體 ID（必須是同一帳號同一地區）

receiverId

String

關聯的 chat 智能體會話的使用者識別碼

屬性名稱

類型

描述

shareId

String?

智能體分享 ID

agentType

ARTCAICallAgentType

智能體工作量類型

expireTime

Date?

到期時間

region

String?

Agent 所在地區

templateConfig

String?

模板配置（JSON 字串）

userData

[String: Any]?

使用者自訂資訊，該資訊最終傳給智能體

屬性名稱

類型

描述

dimensions

CGSize

推流解析度

frameRate

Int

推流幀率

bitrate

Int

推流碼率

keyFrameInterval

Int

推流主要畫面格間隔（毫秒）

useHighQualityPreview

Bool

是否使用高清預覽，否則SDK根據推流解析度自動調整

cameraCaptureFrameRate

Int

預覽解析度

useFrontCameraDefault

Bool

是否預設啟動自拍

屬性名稱

類型

描述

agentGreeting

String?

智能體歡迎語，為空白表示使用智能體配置值

wakeUpQuery

String?

使用者在通話啟動前的指令，用於智能體在通話啟動後立即響應

agentMaxIdleTime

Int32

智能體閑時的最大等待時間（單位：秒），逾時智能體自動下線，預設值為600s

userOnlineTimeout

Int32

使用者未入會，智能體逾時關閉任務的時間，預設值為60s

userOfflineTimeout

Int32

使用者退會後，智能體逾時關閉任務的時間，預設值為5s

enablePushToTalk

Bool

是否開啟對講機模式

agentGracefulShutdown

Bool

是否優雅下線

volume

Int32

智能體說話的音量，範圍為 0~400，預設值為100

workflowOverrideParams

[String: Any]?

工作流程覆蓋參數

enableIntelligentSegment

Bool

智能斷句開關

asrConfig

ARTCAICallAgentAsrConfig

語音辨識配置

ttsConfig

ARTCAICallAgentTtsConfig

語音合成配置

llmConfig

ARTCAICallAgentLlmConfig

大語言模型配置

avatarConfig

ARTCAICallAgentAvatarConfig

數字人配置

interruptConfig

ARTCAICallAgentInterruptConfig

打斷配置

voiceprintConfig

ARTCAICallAgentVoiceprintConfig

聲紋降噪配置

turnDetectionConfig

ARTCAICallAgentTurnDetectionConfig

輪次檢測配置

experimentalConfig

ARTCAICallExperimentalConfig

非產品化定製化配置

vcrConfig

ARTCAICallAgentVcrConfig

VCR配置

屬性名稱

類型

描述

asrLanguageId

String?

ASR語種Id，為空白表示使用智能體配置值

asrMaxSilence

Int32

語音斷句檢測閾值，靜音時間長度超過該閾值會被認為斷句，預設值為400ms，參數範圍 200ms～1200ms

asrHotWords

[String]?

ASR熱詞列表，限制：500個詞及以內，每個詞不超過10個字元

vadLevel

Int32

設定AIVad的靈敏度參數，預設值為3，取值範圍：[0,10]

customParams

String?

自接入ASR時，傳入運行時參數，使用URL參數形式，例如："mode=fast&sample=16000&format=wav"

vadDuration

Int32

語音活動檢測的最短期間閾值用於調節打斷的靈敏度。預設為0，表示關閉此功能；有效範圍為200到2000毫秒，常用範圍為[200,500]，對應1到4個字。如果設定的值小於0，則該值將不會發送至服務端（服務端預設關閉此功能）。

屬性名稱

類型

描述

agentVoiceId

String?

智能體講話音色Id，為空白表示使用智能體配置值

pronunciationRules

[[String: Any]]?

發音規則數組，最多支援 20 條規則。若為 nil 或空數組，則不使用任何規則。樣本如下：

 [
  {
      "Word": "重疊",                       // 目標詞
      "Pronunciation": "寵疊",              // 替換髮音
      "Type": "replacement"                // 多音字規則
  },
  {
      "Word": "行動",
      "Pronunciation": "航動",
      "Type": "replacement"
  }
]

speechRate

Double

TTS播報語速，支援所有TTS類型，取值範圍為[0.5, 2.0]，預設值為1.0，小於0則不會發給服務端（使用控制台配置值）。

languageId

String?

TTS播報語種代碼，當TTS類型為MiniMax有效。

emotion

String?

TTS播報情緒類型，當TTS類型為MiniMax有效。

modelId

String?

TTS模型Id，當前僅支援minimax，可選值：speech-01-turbo / speech-02-turbo。

屬性名稱

類型

描述

llmHistoryLimit

Int32

歷史對話上下文最大保留輪次，預設值為10

llmSystemPrompt

String?

LLM的系統提示詞

bailianAppParams

[String: Any]?

百鍊應用中心參數

llmCompleteReply

boolean

是否發送完整的LLM結果。

openAIExtraQuery

String?

額外的OpenAI協議LLM的查詢參數。

屬性名稱

類型

描述

agentAvatarId

String?

數字人模型Id，為空白表示使用智能體配置值

屬性名稱

類型

描述

enableVoiceInterrupt

Bool

是否開啟智能打斷

interruptWords

[String]?

觸發對話打斷的特定詞彙或短語

屬性名稱

類型

描述

useVoiceprint

Bool

當前斷句是否使用聲紋降噪識別

voiceprintId

String?

聲紋Id，如果不為空白表示當前通話開啟聲紋降噪能力

屬性名稱

類型

描述

turnEndWords

[String]?

斷句特定詞，例如：“完畢”、“我講完了”

mode

ARTCAICallTurnDetectionMode

判斷使用者說話是否結束模式，預設是Semantic，使用AI進行語義判斷是否說話結束

semanticWaitDuration

Int32

語義斷句自訂等待時間，單位：毫秒，範圍：[0, 10000]；如果小於0則不會發給服務端（使用服務端預設值-1，AI自動判斷合適的等待時間）

屬性名稱

類型

描述

resultData

[String]?

智能體返回的所有的VCR檢測結果

stillFrameMotionResult

FrameMotionResult?

VCR的靜音幀檢測結果

invalidFrameMotionResult

FrameMotionResult?

VCR的無效幀檢測結果

peopleCountResult

PeopleCountResult?

VCR的即時畫面人數檢測結果

equipmentResult

EquipmentResult?

VCR的電子裝置檢測結果

headMotionResult

HeadMotionResult?

VCR的頭部動作檢測結果

屬性名稱

類型

描述

data

[String]?

當使用者傳json對象進來時，緩衝起來，後面產生json字串時，使用該對象，這樣可以做到自訂擴充

stillFrameMotion

ARTCAICallAgentVcrFrameMotionConfig?

VCR的靜音幀檢測配置

invalidFrameMotion

ARTCAICallAgentVcrFrameMotionConfig?

VCR的無效幀檢測配置

peopleCount

ARTCAICallAgentVcrBaseConfig?

VCR的即時畫面人數檢測配置

equipment

ARTCAICallAgentVcrBaseConfig?

VCR的電子裝置檢測配置

headMotion

ARTCAICallAgentVcrBaseConfig?

VCR的頭部動作檢測配置

屬性名稱

類型

描述

enable

Boolean

是否啟用，預設開啟

屬性名稱

類型

描述

callbackDelay

Int32

多少毫秒後觸發回調，預設3000ms

屬性名稱

類型

描述

rtcSdkParams

[String: Any]?

rtcsdk參數

commonParams

[String: Any]?

通用參數