1.0.10 • Published 3 years ago

uftcsapi v1.0.10

Weekly downloads
-
License
ISC
Repository
-
Last release
3 years ago

Enums

Enumeration: ConferenceStyle

会议类型

Table of contents

Enumeration Members

Enumeration Members

Broadcast

Broadcast = 1

广播模式


Interactive

Interactive = 0

自由讨论模式(默认)

Enumeration: MemberCallState

会议成员呼叫状态

Table of contents

Enumeration Members

Enumeration Members

Alert

Alert = 2

振铃中


Connected

Connected = 3

通话中


Idle

Idle = 0

空闲


Proceeding

Proceeding = 1

正在呼叫中

Enumeration: MemberType

会议成员类型

Table of contents

Enumeration Members

Enumeration Members

Audience

Audience = 0

普通听众


Chairman

Chairman = 2

会议主持


Dispatcher

Dispatcher = 3

调度操作员


Speaker

Speaker = 1

发言者

Enumeration: MsgCatalog

消息类别

Table of contents

Enumeration Members

Enumeration Members

Event

Event = 2

事件消息


Request

Request = 0

请求消息


Response

Response = 1

响应消息

Enumeration: MsgTypes

协议消息类型ID

Table of contents

Enumeration Members

Enumeration Members

CmdConferenceBackgroundMusic

CmdConferenceBackgroundMusic = 10


CmdConferenceCallInForbidden

CmdConferenceCallInForbidden = 8


CmdConferenceGetDetail

CmdConferenceGetDetail = 4


CmdConferenceInviteAll

CmdConferenceInviteAll = 11


CmdConferenceKeepInvite

CmdConferenceKeepInvite = 7


CmdConferenceRecord

CmdConferenceRecord = 9


CmdConferenceSave

CmdConferenceSave = 5


CmdConferenceSetStyle

CmdConferenceSetStyle = 6


CmdKeepAlive

CmdKeepAlive = 3


CmdMemberBye

CmdMemberBye = 14


CmdMemberDel

CmdMemberDel = 13


CmdMemberInvite

CmdMemberInvite = 12


CmdMemberSetName

CmdMemberSetName = 16


CmdMemberSetType

CmdMemberSetType = 15


EvtConferenceBackgroudMusic

EvtConferenceBackgroudMusic = 22


EvtConferenceCallInForbidden

EvtConferenceCallInForbidden = 20


EvtConferenceKeepInvite

EvtConferenceKeepInvite = 19


EvtConferenceRecord

EvtConferenceRecord = 21


EvtConferenceStop

EvtConferenceStop = 17


EvtConferenceStyle

EvtConferenceStyle = 18


EvtMemberDel

EvtMemberDel = 24


EvtMemberState

EvtMemberState = 23


RespApiObjID

RespApiObjID = 1


RespError

RespError = 2


RespOK

RespOK = 0

Enumeration: RepeatPeriod

预约会议重复周期

Table of contents

Enumeration Members

Enumeration Members

Day

Day = 0

每天


Month

Month = 2

每月


Once

Once = 4

单次


Week

Week = 1

每周


Year

Year = 3

每年

Enumeration: SpeakReqMode

发言请求模式

Table of contents

Enumeration Members

Enumeration Members

Password

Password = 1

密码触发模式


RaiseHand

RaiseHand = 0

举手申请模式(默认)

uftcsapi

Table of contents

Enumerations

Type Aliases

Functions

Type Aliases

ConferenceConfig

Ƭ ConferenceConfig: Object

会议室配置

Type declaration

NameTypeDescription
autoRecordboolean是否自动录音
backgroundMusicboolean是否播放背景音乐
callInDoubleCheckboolean预设号码呼入是否要验证密码
callInForbiddenboolean是否禁止非预设号码呼入
dispatcherControlStartboolean调度员呼入是否自动开始会议
dispatcherControlStopboolean调度员挂机是否结束会议
id?number会议室ID,系统统一自动分配
indexTags?string自定义主题索引,允许多个以逗号分开
keepInviteboolean是否自动追呼
membersMember[]成员列表
owner?string归属用户ID
pwdAudiencestring听众密码
pwdDispatcherstring调度员密码
pwdSpeakerstring发言者密码
schedule?ScheduleItem[]定时会议预约参数
speakReqModeSpeakReqMode发言请求模式
styleConferenceStyle会议模式
topic?string会议主题说明

ConferenceDetailState

Ƭ ConferenceDetailState: Object

会议室实时详细状态

Type declaration

NameTypeDescription
membersMemberState[]成员状态列表
overallConferenceState总体状态

ConferenceProfile

Ƭ ConferenceProfile: Object

会议室配置概览

Type declaration

NameTypeDescription
createTimestring创建时间
idnumber会议室ID
memberNumbernumber预设成员总数
ownerstring归属用户
styleConferenceStyle会议模式
topicstring会议主题说明

ConferenceState

Ƭ ConferenceState: Object

会议室实时状态

Type declaration

NameTypeDescription
backgroudMusicboolean是否在播放背景音乐
callInForbiddenboolean是否禁止非预设号码呼入
connectedCountnumber接通成员数
keepInviteboolean是否自动追呼
memberCountnumber实际会议成员数
recordingboolean是否在录音
startTimenumber会议开始时间戳
styleConferenceStyle会议模式

ConferenceStateCallbacks

Ƭ ConferenceStateCallbacks: Object

控制中会议状态事件回调函数

Type declaration

NameType
onBackgroundMusic?(on: boolean) => void
onCallInForbidden?(enable: boolean) => void
onControlDown(cause: string) => void
onKeepInvite?(enable: boolean) => void
onMember?(state: MemberState) => void
onMemberDel?(telNumber: string) => void
onRecording?(on: boolean) => void
onStop() => void
onStyle?(style: ConferenceStyle) => void

Member

Ƭ Member: Object

会议成员配置

Type declaration

NameTypeDescription
namestring成员名称
telNumberstring成员电话号码
typeMemberType成员身份类型

MemberInvite

Ƭ MemberInvite: Object

邀请会议成员参数

Type declaration

NameTypeDescription
name?string名称,可缺省
telNumberstring电话号码
type?MemberType身份类型, 缺省时默认值根据会议模式确定,交互会议时为发言人,广播会议时为普通听众

MemberState

Ƭ MemberState: Object

会议成员状态

Type declaration

NameTypeDescription
callState?MemberCallState呼叫状态
inCom?boolean是否呼入成员
name?string成员名称
raiseHand?boolean是否举手请求发言
telNumberstring成员电话号码
type?MemberType成员身份类型

Message

Ƭ Message: Object

协议消息结构

Type declaration

NameTypeDescription
CatalogMsgCatalog消息分类
ErrorMsg?string出错信息
InvokeIDnumber调用ID
MsgTypeMsgTypes消息具体类型
Param?any调用参数
Ret?any调用返回结果

ResultOfConferenceList

Ƭ ResultOfConferenceList: Object

会议室检索列表返回结果数据结构

Type declaration

NameTypeDescription
itemsConferenceProfile[]会议室项目列表(offset,rows范围)
totalnumber满足检索条件会议室项目总数

ResultOfUserList

Ƭ ResultOfUserList: Object

用户检索列表返回结果数据结构

Type declaration

NameTypeDescription
itemsUser[]用户项目列表(offset,rows范围)
totalnumber满足检索条件用户项目总数

ScheduleItem

Ƭ ScheduleItem: Object

定时会议预约项

Type declaration

NameTypeDescription
day?number日期,period=Year|Month|Once时需要
hournumber小时
minutenumber分钟
month?number月,period=Year|Once时需要
periodRepeatPeriod重复周期
weekDay?number星期,period=Week时需要
year?number年,period=Once时需要

Session

Ƭ Session: Object

终端登录会话状态数据结构

Type declaration

NameTypeDescription
administratorboolean登录用户是否管理员
auth_idstring登录认证成功后返回的会话ID
errMsgstring服务器最近返回错误信息
inProgressboolean是否正在登录
lastRequestIndexnumber最近发送请求序号
pwdstring用户登录密码
userIdstring用户状态
userNamestring用户名称

StorageStateSummary

Ƭ StorageStateSummary: Object

数据存储状态配置

Type declaration

NameTypeDescription
recordTotalTimestring录音净时长总计
remainDurationstring剩余可存储时长
storageAutoCleanboolean硬盘是否自动清理
storageAutoCleanTimePerDaynumber硬盘自动清理时间
storageKeepDaysnumber历史存储记录保存天数
storageTotalnumber数据硬盘总容量
storageUsednumber数据硬盘占用
storedDurationstring记录已存储时长

SystemStateSummary

Ƭ SystemStateSummary: Object

系统状态概览数据结构

Type declaration

NameTypeDescription
conferenceTotalnumber占用会议室总数
partyTotalnumber会议授权总方数
partyUsednumber会议占用总方数
system{ cpuUsed: number ; memoryTotal: number ; memoryUsed: number ; storageTotal: number ; storageUsed: number }系统资源
system.cpuUsednumberCPU占用
system.memoryTotalnumber内存总数
system.memoryUsednumber内存占用
system.storageTotalnumber数据硬盘总容量
system.storageUsednumber数据硬盘占用

User

Ƭ User: Object

用户账号

Type declaration

NameTypeDescription
administratorboolean是否管理员用户
bizCode?string登录密码
createTime?string | Date创建时间
enabledboolean是否启用
id?string登录ID
indexTags?string自定义用户索引,允许多个以逗号分开
namestring名称
namePy?string名称拼音首字母

UserState

Ƭ UserState: Object

用户登录状态

Type declaration

NameTypeDescription
conference?{ id: number ; topic: string }控制会议室
conference.idnumber会议室ID
conference.topicstring会议主题
ipAddrstring终端IP地址
loginDurationstring登录时长
loginTimestring登录时间

Functions

conferenceAdd

conferenceAdd(config): Promise<number>

新建会议室

Parameters

NameTypeDescription
configConferenceConfig会议室配置参数 ConferenceConfig

Returns

Promise<number>

系统自动生成的唯一性ID


conferenceBackgroundMusic

conferenceBackgroundMusic(enable): Promise<void>

会议中启动/停止背景音乐

Parameters

NameTypeDescription
enableboolean是否播放背景音乐

Returns

Promise<void>


conferenceCallInForbidden

conferenceCallInForbidden(enable): Promise<void>

会议中设置是否禁止非预设成员呼入

Parameters

NameTypeDescription
enableboolean是否禁止呼入

Returns

Promise<void>


conferenceControlStart

conferenceControlStart(id, callbacks): Promise<ConferenceDetailState>

会议室启动控制

Parameters

NameTypeDescription
idnumber会议室ID
callbacksConferenceStateCallbacks会议实时状态刷新事件回调函数

Returns

Promise<ConferenceDetailState>

会议初始详细状态 ConferenceDetailState


conferenceControlStop

conferenceControlStop(): Promise<void>

会议室释放控制

Returns

Promise<void>


conferenceDel

conferenceDel(id): Promise<void>

删除会议室

Parameters

NameTypeDescription
idnumber会议室ID

Returns

Promise<void>


conferenceInviteAll

conferenceInviteAll(): Promise<void>

会议中启动群呼

Returns

Promise<void>


conferenceKeepInvite

conferenceKeepInvite(enable): Promise<void>

会议中设置会议成员自动追呼

Parameters

NameTypeDescription
enableboolean是否自动追呼

Returns

Promise<void>


conferenceList

conferenceList(offset, rows, filterByTopic?): Promise<ResultOfConferenceList>

会议室列表

Parameters

NameTypeDescription
offsetnumber返回记录起始偏移量
rowsnumber最大返回项目数
filterByTopic?string按主题搜索过滤字符串(拼音首字母前缀或主题文字)

Returns

Promise<ResultOfConferenceList>

会议室概览数据列表 ConferenceProfile[]


conferenceLoad

conferenceLoad(id): Promise<ConferenceConfig>

加载会议室详细配置

Parameters

NameTypeDescription
idnumber会议室ID

Returns

Promise<ConferenceConfig>

会议室配置数据 ConferenceConfig


conferenceMemberBye

conferenceMemberBye(telNumber): Promise<void>

会议中拆除会议成员

Parameters

NameTypeDescription
telNumberstring成员电话号码

Returns

Promise<void>


conferenceMemberDel

conferenceMemberDel(telNumber): Promise<void>

会议中删除会议成员

Parameters

NameTypeDescription
telNumberstring成员电话号码

Returns

Promise<void>


conferenceMemberInvite

conferenceMemberInvite(member): Promise<void>

会议中邀请会议成员

Parameters

NameTypeDescription
memberMemberInvite会议成员配置参数 MemberInvite

Returns

Promise<void>


conferenceMemberSetName

conferenceMemberSetName(telNumber, name): Promise<void>

会议中命名会议成员

Parameters

NameTypeDescription
telNumberstring成员电话号码
namestring成员名称

Returns

Promise<void>


conferenceMemberSetType

conferenceMemberSetType(telNumber, type): Promise<void>

会议中设置会议成员类型

Parameters

NameTypeDescription
telNumberstring成员电话号码
typeMemberType会议成员类型 MemberType

Returns

Promise<void>


conferenceRecording

conferenceRecording(enable): Promise<void>

会议中启动/停止录音

Parameters

NameTypeDescription
enableboolean是否录音

Returns

Promise<void>


conferenceSave

conferenceSave(): Promise<void>

保存控制中会议室配置

Returns

Promise<void>


conferenceSetStyle

conferenceSetStyle(style): Promise<void>

会议中改变会议模式

Parameters

NameTypeDescription
styleConferenceStyle会议模式 ConferenceStyle

Returns

Promise<void>


conferenceStart

conferenceStart(id): Promise<void>

开始会议

Parameters

NameTypeDescription
idnumber会议室ID

Returns

Promise<void>


conferenceStatePoll

conferenceStatePoll(ids): Promise<{ [key: string]: ConferenceState; }>

会议室实时状态查询

Parameters

NameTypeDescription
idsnumber[]欲查询会议室ID列表

Returns

Promise<{ [key: string]: ConferenceState; }>

会议室状态映射表,未开始的会议不返回对应项 { ID: string: ConferenceState }


conferenceStop

conferenceStop(id): Promise<void>

结束会议

Parameters

NameTypeDescription
idnumber会议室ID

Returns

Promise<void>


conferenceSurveillance

conferenceSurveillance(id, monitorTelNumber): Promise<void>

会议室秘密监听

Parameters

NameTypeDescription
idnumber会议室ID
monitorTelNumberstring监听用电话号码

Returns

Promise<void>


conferenceUpdate

conferenceUpdate(config): Promise<void>

更新会议室配置

Parameters

NameTypeDescription
configConferenceConfig会议室ID及配置参数 ConferenceConfig

Returns

Promise<void>


getServerAddress

getServerAddress(): Object

Returns

Object

服务器地址 {hostAddr,ssl}

NameType
hostAddrstring
sslboolean

keepalive

keepalive(): Promise<void>

会话心跳保持

Returns

Promise<void>


login

login(acc, password, onSessionDown?): Promise<undefined | Session>

登录服务器后台

Parameters

NameTypeDescription
accstring登录账号
passwordstring登录密码
onSessionDown?(e: { result: string ; resultComment: string }) => void会话中断回调事件函数

Returns

Promise<undefined | Session>

会话数据结构


logout

logout(): void

登出系统

Returns

void


setServerAddress

setServerAddress(hostAddr, ssl): void

初始化服务器URL地址

Parameters

NameTypeDescription
hostAddrstring服务器IP地址:端口,例如192.168.1.88:3000
sslboolean是否采用SSL加密协议

Returns

void


storageClean

storageClean(password): Promise<void>

清理存储空间

Parameters

NameTypeDescription
passwordstring登录用户密码

Returns

Promise<void>


storageClear

storageClear(password): Promise<void>

初始化存储空间

Parameters

NameTypeDescription
passwordstring登录用户密码

Returns

Promise<void>


storageConfig

storageConfig(password, autoClean, cleanHourPerDay?, keepDays?): Promise<void>

配置存储空间管理参数

Parameters

NameTypeDescription
passwordstring登录用户密码
autoCleanboolean后台自动清理
cleanHourPerDay?number每天清理空间时间
keepDays?number历史记录保持天数

Returns

Promise<void>


storageStateSummaryPoll

storageStateSummaryPoll(): Promise<StorageStateSummary>

轮询存储状态

Returns

Promise<StorageStateSummary>

存储状态概览StorageStateSummary


systemStateSummaryPoll

systemStateSummaryPoll(): Promise<SystemStateSummary>

轮询系统状态

Returns

Promise<SystemStateSummary>

系统状态概览SystemStateSummary


userAdd

userAdd(config): Promise<void>

新建用户

Parameters

NameTypeDescription
configUser用户配置参数 User

Returns

Promise<void>


userDel

userDel(ids): Promise<void>

删除用户

Parameters

NameTypeDescription
idsstring[]用户ID列表

Returns

Promise<void>


userDisable

userDisable(ids): Promise<void>

禁用用户

Parameters

NameTypeDescription
idsstring[]用户ID列表

Returns

Promise<void>


userEnable

userEnable(ids): Promise<void>

启用用户

Parameters

NameTypeDescription
idsstring[]用户ID列表

Returns

Promise<void>


userList

userList(offset, rows, filter?): Promise<ResultOfUserList>

用户列表

Parameters

NameTypeDescription
offsetnumber返回记录起始偏移量
rowsnumber最大返回项目数
filter?string按主题搜索过滤字符串(拼音首字母前缀或主题文字)

Returns

Promise<ResultOfUserList>

用户概览数据列表 User[]


userReset

userReset(ids): Promise<void>

重置用户密码

Parameters

NameTypeDescription
idsstring[]用户ID列表

Returns

Promise<void>


userSetPassword

userSetPassword(oldPass, newPass): Promise<void>

设置当前用户登录密码

Parameters

NameTypeDescription
oldPassstring原密码
newPassstring新密码

Returns

Promise<void>


userStatePoll

userStatePoll(ids): Promise<{ [userId: string]: UserState; }>

用户实时状态查询

Parameters

NameTypeDescription
idsstring[]欲查询用户ID列表

Returns

Promise<{ [userId: string]: UserState; }>

用户登录状态映射表,未登录用户不返回对应项 { userId: string: UserState }


userUpdate

userUpdate(config): Promise<void>

更新用户配置

Parameters

NameTypeDescription
configUser用户ID及配置参数 User

Returns

Promise<void>

1.0.9

3 years ago

1.0.8

3 years ago

1.0.7

3 years ago

1.0.10

3 years ago

1.0.6

3 years ago

1.0.5

3 years ago

1.0.4

3 years ago

1.0.3

3 years ago

1.0.2

3 years ago

1.0.1

3 years ago

1.0.0

3 years ago