UDTestSDK 3.6.3

由 xuchen 维护。

您想将如下类似的内容添加到您的 Podfile 中：pod 'UDTestSDK', '~> 3.6'

target 'MyApp' do
  pod 'UDTestSDK', '~> 3.6'
end

然后在您的终端内或从 CocoaPods.app 运行 pod install

若想测试运行，可以运行以下命令：

pod try UDTestSDK

UDTestSDK 3.6.3

由
xuchen

UdeskSDK-iOS

Udesk为了让开发者更好地集成移动SDK，与企业业务结合更加紧密，我们开源了SDK的UI界面。用户可以根据自身业务以及APP不同风格重写页面。当然开发者也可以直接使用我们提供的默认界面。

一、SDK工作流程

Udesk-SDK的工作流程如下图所示。

二、导入SDK依赖的框架

2.1文件介绍

示例中的文件	说明
UDChatMessage	Udesk提供的开源聊天界面
SDK	Udesk SDK的静态库和头文件

SDK中的文件	说明
UdeskMessage.h	实体类：消息
UdeskManager.h	Udesk SDK 提供的逻辑 API，开发者可调用其中的逻辑接口，实现自定义在线客服界面
libUdesk.a	Udesk SDK 提供的静态库，实现了SDK底层逻辑

2.2引入依赖库

Udesk SDK 的实现，依赖了一些系统框架，在开发应用时，需要在工程里加入这些框架。开发者首先点击工程右边的工程名，然后在工程名右边依次选择 TARGETS -> BuiLd Phases -> Link Binary With Libraries，展开 LinkBinary With Libraries 后单击展开后下面的 + 来添加下面的依赖项

libz.tbd
libxml2.tbd
libresolv.tbd
libsqlite3.tbd

2.3将SDK添加到您的工程

将下载的文件夹中的UdeskSDK文件夹拖到您的工程中，并进行以下配置

点击您的工程targets->Build Settings
搜索 Other Linker Flags 添加 -lxml2 -ObjC
搜索 header search paths 添加 /usr/include/libxml2

2.4权限问题

如果您使用的是Xcode8，请在你项目的Info.plist文件中添加相册、相机、麦克风的权限

三、快速集成SDK

Udesk提供了一套开源的聊天界面，帮助开发者快速创建对话窗口和帮助中心，并提供自定义接口，以满足定制需求。

3.1初始化Udesk SDK

获取appkey和appId。

注意：appKey、appID、domain都是必填字段。

//初始化Udesk
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
	// Override point for customization after application launch.
    [UdeskManager initWithAppKey:@"App Key" appId:@"App ID" domain:@"公司注册的Udesk域名"];
	return YES;
}

3.2初始化客户信息

用户系统字段是Udesk已定义好的字段，开发者可以传入这些用户信息，供客服查看。

NSDictionary *parameters = @{
@"user": @{
@"nick_name": @"小明",
@"cellphone":@"18888888888",
@"email":@"[email protected]",
@"description":@"用户描述",
@"sdk_token":@"xxxxxxxxxxx"
}
}
[UdeskManager createCustomerWithCustomerInfo:parameters];

3.3 推出聊天页面

//使用push
UdeskSDKManager *chat = [[UdeskSDKManager alloc] initWithSDKStyle:[UdeskSDKStyle defaultStyle]];
[chat pushUdeskInViewController:self completion:nil];

//使用present
[chat presentUdeskInViewController:self completion:nil];

3.4 推出帮助中心

//使用push
UdeskSDKManager *faq = [[UdeskSDKManager alloc] initWithSDKStyle:[UdeskSDKStyle defaultStyle]];
[faq pushUdeskInViewController:self udeskType:UdeskFAQ completion:nil];

//使用present
[faq presentUdeskInViewController:self udeskType:UdeskFAQ completion:nil];

四、Udesk SDK 自定义配置

4.1 使用SDK提供的UI

原生

UdeskSDKManager *manager = [[UdeskSDKManager alloc] initWithSDKStyle:[UdeskSDKStyle defaultStyle]];
[manager pushUdeskInViewController:self completion:nil];

经典

UdeskSDKManager *manager = [[UdeskSDKManager alloc] initWithSDKStyle:[UdeskSDKStyle blueStyle]];
[manager presentUdeskInViewController:self completion:nil];

4.2 自定义UI

//此处只是示例，更多UI参数请参看 UdeskSDKStyle.h
UdeskSDKStyle *sdkStyle = [UdeskSDKStyle customStyle];
sdkStyle.navigationColor = [UIColor yellowColor];
sdkStyle.titleColor = [UIColor orangeColor];

UdeskSDKManager *chat = [[UdeskSDKManager alloc] initWithSDKStyle:sdkStyle];
[chat pushUdeskInViewController:self completion:nil];

4.3 指定客服ID

UdeskSDKManager *chat = [[UdeskSDKManager alloc] initWithSDKStyle:[UdeskSDKStyle defaultStyle]];
[chat setScheduledAgentId:agentId];
[chat pushUdeskInViewController:self udeskType:UdeskIM completion:nil];

4.4 指定客服组ID

UdeskSDKManager *chat = [[UdeskSDKManager alloc] initWithSDKStyle:[UdeskSDKStyle defaultStyle]];
[chat setScheduledGroupId:groupId];
[chat pushUdeskInViewController:self udeskType:UdeskIM completion:nil];

4.5 设置用户头像

UdeskSDKManager *chat = [[UdeskSDKManager alloc] initWithSDKStyle:[UdeskSDKStyle defaultStyle]];
//通过URL设置头像
[chat setCustomerAvatarWithURL:@"头像URL"];
//通过本地图片设置头像
[chat setCustomerAvatarWithImage:[UIImage imageNamed:@"customer"]];
[chat pushUdeskInViewController:self completion:nil];

4.6 设置SDK语言

#import "UdeskLanguageTool.h"
//SDK提供两种语言，中文(CNS) 、英文 (EN) ，默认中文
[[UdeskLanguageTool sharedInstance] setNewLanguage:EN]

4.7 设置放弃排队类型

UdeskSDKManager *chatViewManager = [[UdeskSDKManager alloc] initWithSDKStyle:[UdeskSDKStyle defaultStyle]];
//如果用户处于排队状态，当用户离开聊天界面，会强制把该用户移除排队
//默认为标记排队（指不会放弃排队）
[chatViewManager setQuitQueueType:UdeskForceQuit];
[chatViewManager pushUdeskInViewController:self completion:nil];

4.8 自定义留言界面

UdeskSDKManager *chatViewManager = [[UdeskSDKManager alloc] initWithSDKStyle:[UdeskSDKStyle defaultStyle]];
//点击留言回调
[chatViewManager leaveMessageButtonAction:^(UIViewController *viewController){
  
    UdeskTicketViewController *offLineTicket = [[UdeskTicketViewController alloc] init];
    [viewController presentViewController:offLineTicket animated:YES completion:nil];
}];

注意：如果你自定义的留言界面是h5的，恰好你们有上传附件的功能，这时候你们需要添加以下代码到你们自定义的控制器，否则选择附件的时候会直接返回到上一页

1. 使用presentViewController 进入到留言页

2. 重写dismissViewControllerAnimated方法

- (void)dismissViewControllerAnimated:(BOOL)flag completion:(void (^)(void))completion {
    if ( self.presentedViewController)
    {
        [super dismissViewControllerAnimated:flag completion:completion];
    }
}

3. 在需要dismiss的时候调用：

[super dismissViewControllerAnimated:flag completion:completion];

五、消息推送

当前仅支持一种推送方案，即Udesk服务端发送消息至开发者的服务端，开发者再推送消息到 App。

未来Udesk iOS SDK 将会支持直接推送消息给 App，即开发者可上传 App 的推送证书至 Udesk，Udesk 将推送消息至苹果 APNS 服务器。

设置接收推送的服务器地址

推送消息将会发送至开发者的服务器。

设置推送服务器地址，请使用 Udesk 管理员帐号登录 Udesk，在「设置」 -> 「移动SDK」中设置。

上传设备的 deviceToken

App 进入后台后，Udesk推送给开发者服务端的消息数据格式中，会有 deviceToken 的字段。

将下列代码添加到 AppDelegate.m 中系统回调 didRegisterForRemoteNotificationsWithDeviceToken 中：

[UdeskManager registerDeviceToken:deviceToken];

通知 Udesk 服务端发送消息至开发者的服务端

目前，Udesk 的推送是通过推送消息给开发者提供的 URL 上来实现的。

在 App 进入后台时，应该通知 Udesk 服务端，让其将以后的消息推送给开发者提供的服务器地址。

开发者需要在 AppDelegate.m 的系统回调 applicationDidEnterBackground 调用开启推送服务接口，如下代码：

- (void)applicationDidEnterBackground:(UIApplication *)application {

  __block UIBackgroundTaskIdentifier background_task;
  //注册一个后台任务，告诉系统我们需要向系统借一些事件
  background_task = [application beginBackgroundTaskWithExpirationHandler:^ {
  
//不管有没有完成，结束background_task任务
  [application endBackgroundTask: background_task];
  background_task = UIBackgroundTaskInvalid;
    }];

  dispatch_async(dispatch_get_global_queue(DISPATCH_QUEUE_PRIORITY_DEFAULT, 0), ^{
      //根据需求 开启／关闭 通知
      [UdeskManager startUdeskPush];
  });
}

关闭 Udesk 推送

在 App 进入前台时，应该通知 Udesk 服务端，让其将以后的消息发送给 SDK，而不再推送给开发者提供的服务端。

开发者需要在 AppDelegate.m 的系统回调 applicationWillEnterForeground 调用关闭推送并拉取消息接口，如下代码：

- (void)applicationWillEnterForeground:(UIApplication *)application {

    //上线操作，拉取离线消息
    [UdeskManager setupCustomerOnline];
}

离线推送接口要求

基本要求

推送接口只支持 http，不支持 https
数据将以JSON格式发送
请求Body数据为JSON格式，见示例
请求时使用的content-type为application/x-www-form-urlencoded

参数

当有消息或事件发生时，将会向推送接口传输以下数据

参数名	类型	说明
message_id	string	消息id
platform	string	平台，'ios'或'android'
device_token	string	设备标识
app_id	string	SDK app id
content	string	消息内容，仅type为'message'时有效
sent_at	datetime	消息推送时间，格式iso8601
from_id	integer	发送者id(客服)
from_name	string	发送者名称
to_id	integer	接收者id(客户)
to_token	string	接收者 sdk_token(唯一标识)
type	string	消息类型，'event'为事件，'message'为消息
event	string	事件类型，'redirect'客服转接，'close'对话关闭，'survey'发送满意度调查

参数示例

{
    "message_id": "di121jdlasf82jfdasfklj39dfda",
    "platform": "ios",
    "device_token": "4312kjklfds2",
    "app_id": "dafjidalledaf",
    "content": "Hello world!",
    "sent_at": "2016-11-21T10:40:38+08:00",
    "from_id": 231,
    "from_name": "Tom",
    "to_id": 12,
    "to_token": "dae121dccepm1",
    "type": "message",
  	"event": "close"
}

注意：如果你不使用推送

，请将app切换到后台后调用以下接口

- (void)applicationDidEnterBackground:(UIApplication *)application {
  
  	//设置离线，客服发送离线消息
	[UdeskManager setupCustomerOffline]
}

，请在切换到前台后调用以下接口

- (void)applicationWillEnterForeground:(UIApplication *)application {

    //上线操作，拉取离线消息
    [UdeskManager setupCustomerOnline];
}

六、Udesk SDK API说明

注意：以下接口在Udesk开源UI中均有调用，如果你使用Udesk开源UI则不需要调用以下任何接口

6.1初始化SDK

//初始化Udesk
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
// Override point for customization after application launch.    
[UdeskManager initWithAppKey:@"App Key" appId:@"App ID" domain:@"公司注册的Udesk域名"]; 
return YES;
}

6.2初始化客户信息

注意：若要在SDK中使用用户自定义字段，需先在管理员网页端设置添加用户自定义字段。用户字段包含了一名客户的所有数据。目前Udesk支持自定义客户字段，您可以选择输入型字段、选择型字段或其他类型字段。

用户系统字段是Udesk已定义好的字段，开发者可以传入这些用户信息，供客服查看。

NSDictionary *parameters = @{
@"user": @{
@"nick_name": @"小明",
@"cellphone":@"18888888888",
@"email":@"[email protected]",
@"description":@"用户描述",
@"sdk_token":@"xxxxxxxxxxx"
}
}
[UdeskManager createCustomerWithCustomerInfo:parameters];

默认客户字段说明

key	是否必选	说明
sdk_token	必选	用户唯一标识
cellphone	可选	用户手机号
email	可选	邮箱账号
description	可选	用户描述
nick_name	可选	用户名字

注意 sdktoken 是客户的唯一标识，用来识别身份，sdk_token: 传入的字符请使用字母 / 数字等常见字符集 ，就如同身份证一样，不允许出现一个身份证号对应多个人，或者一个人有多个身份证号；其次如果给顾客设置了邮箱和手机号码，也要保证不同顾客对应的手机号和邮箱不同，如出现相同的，则不会创建新顾客。

6.2.1添加客户自定义字段

客户自定义字段需要管理员登录Udesk后台进入【管理中心-用户字段】添加用户自定义字段。

调用用户自定义字段函数

//获取用户自定义字段
[UdeskManager getCustomerFields:^(id responseObject, NSError *error) {

//NSLog(@"用户自定义字段：%@",responseObject);
}];

返回信息：

fieldsDict:{
message = success;
status = 0;
"user_fields" =     (
{
comment = “测试测试”;      
"content_type" = droplist; 
"field_label" = "测试";  
"field_name" = “SelectField_109";   ——————用户自定义字段key
options =             (    
{
0 = "测试用户自定义字段";
}
);
permission = 0;
requirment = 1;
};
}

使用：添加key值"customer_field"，类型为字典，根据返回的信息field_name的value作为key，value根据需求定义。把这个键值对添加到customer_field中。最后把customer_field添加到用户信息参数的user字典里。示例

NSDictionary *parameters = @{
@"user": @{
@"sdk_token": sdk_token,
@"nick_name":nick_name,
@"email":email,
@"cellphone":cellphone,
@"description":@"用户描述",
@"customer_field":@{
@"TextField_390":@"测试测试",
@"SelectField_455":@[@"1"]
}

}
};

6.2.2创建用户

此接口为必调用，否则无法使用SDK

[UdeskManager createCustomerWithCustomerInfo:parameters];

6.2.3更新用户信息

根据需求自定义，不调用不影响主流程

注意：

参数结构与创建用户信息的结构体大致相同（不需要传sdk_token）
用户自定义字段"customer_field"改为"custom_fields"，其他不变
请不要使用已经存在的邮箱或者手机号进行更新，否则会更新失败！

NSDictionary *updateParameters = @{
@"user" : @{
@"nick_name":@"测试更新10",
@"cellphone":@"323312110198754326231123",
@"description":@"用户10描述",
@"email":@"[email protected]",
@"custom_fields":@{
@"TextField_390":@"测试测试",
@"SelectField_455":@[@"1"]
}
}
};

[UdeskManager updateUserInformation:updateParameters];

6.3添加咨询对象

根据需求自定义，不调用不影响主流程

参数名	类型	说明	必填
productImageUrl	string	咨询对象图片	是
productTitle	string	咨询对象标题	是
productDetail	string	咨询对象副标题	是
productURL	string	咨询对象连接	是

示例

 UdeskSDKManager *chat = [[UdeskSDKManager alloc] initWithSDKStyle:[UdeskSDKStyle defaultStyle]];
 
 NSDictionary *dict = @{                  											                                   @"productImageUrl":@"http://img.club.pchome.net/kdsarticle/2013/11small/21/fd548da909d64a988da20fa							0ec124ef3_1000x750.jpg",
                        @"productTitle":@"测试测试测试测你测试测试测你测试测试测你测试测试测你测试测试测									    你测试测试测你！",
                        @"productDetail":@"¥88888.088888.088888.0",
                        @"productURL":@"http://www.baidu.com"
                        };
 [chat setProductMessage:dict];
 [chat pushUdeskInViewController:self completion:nil];

SDK咨询对象展示

6.4请求分配客服

在获取当前客户的帐号信息后，调用此接口，请求分配客服，获得客服信息和排队信息，可参考开源UI

[UdeskManager requestRandomAgent:^(UdeskAgent *agent, NSError *error) {  

//返回客服信息
}];

6.5指定分配客服

在获取当前客户的帐号信息后，调用此接口可主动指定分配客服，获得客服信息和排队信息，可参考开源UI

[UdeskManager scheduledAgentId:agentId completion:^(UdeskAgent *agent, NSError *error) {

}];

6.6指定分配客服组

在获取当前客户的帐号信息后，调用此接口可主动指定分配客服组，获得客服信息和排队信息，可参考开源UI

[UdeskManager scheduledGroupId:groupId completion:^(UdeskAgent *agent, NSError *error) {

}];

获取客服和客服组ID

使用管理员登录Udesk系统

管理员在【管理中心-即时通讯-网页插件-管理默认网站接入插件-基本信息-专用链接】中选择指定的客服组或客服，可看到客服ID和客服组ID。

6.7断开与Udesk服务器连接

切换用户时，调用此接口断开之前用户的连接

[UdeskManager logoutUdesk];

6.8设置客户上线

在连接到Udesk服务器后，客户默认是在线的。如果设置客户为离线后，调用此接口可以使客户重新上线。

[UdeskManager setupCustomerOnline];

6.8设置客户离线

将客户设置为离线，如果用户开启了推送，开发者无需调用。

[UdeskManager setupCustomerOffline];

6.9设置接收消息代理

设置接收消息的代理，由代理负责接收消息。

设置代理后，通过实现 UDManagerDelegate 中的 didReceiveMessages: didReceivePresence: didReceiveSurvey:withAgentId: 方法，可以通过这些代理函数接收消息。

[UdeskManager receiveUdeskDelegate:self];

6.10发送消息

调用此接口可以发送各种类型的消息，请注意选择正确的消息类型。

//message消息类型为 UdeskMessage
[UdeskManager sendMessage:message completion:^(UdeskMessage *message,BOOL sendStatus) {    

}];

6.11输入预知

将用户正在输入的内容实时显示在客服对话窗口中。此接口没有调用限制，但每1秒内只会向服务器发送一次数据。

注意：此功能只在没有初始化失败且客服在线时调用才有效。

[UdeskManager sendClientInputtingWithContent:text];

6.12获取客户本地聊天数据

[UdeskManager getHistoryMessagesFromDatabaseWithMessageDate:[NSDate date] messagesNumber:20 result:^(NSArray *messagesArray) {
        
}];

6.13监听收到未读消息的广播

开发者在合适的位置监听收到消息的广播，用于提醒顾客有新消息。广播名称为 UD_RECEIVED_NEW_MESSAGES_NOTIFICATION，定义在 UdeskManager.h 中。

6.14获取未读消息数量

开发者可以在需要显示未读消息数时调用此接口，当用户进入聊天界面后，未读消息将会清零。

[UdeskManager getLocalUnreadeMessagesCount];

6.15获取未读消息

开发者可以在需要显示未读消息时调用此接口，当用户进入聊天界面后，未读消息将会清空。

[UdeskManager getLocalUnreadeMessages];

6.16获取机器人URL

当前SDK的机器人是通过web网页实现，通过此接口可以获取机器人网页的URL，在webview中打开后即可与机器人对话。

[UdeskManager getRobotURL:^(NSURL *robotUrl) {
}];

6.17判断客户是否正在会话

返回“是/否”，若返回“否”则用户不在会话，返回“是”则客户在客服的聊天列表中。

BOOL isSession = [UdeskManager customersAreSession];

6.18将所有未读消息设置为已读

可以将客户的未读消息重置。

[UdeskManager markAllMessagesAsRead];

七、常见问题

键盘弹起后输入框和键盘之间有偏移

请检查是否使用了第三方开源库IQKeyboardManager，该库与输入框的判断逻辑冲突。

在 UdeskChatViewController 的 viewWillAppear 方法中加入 [[IQKeyboardManager sharedManager] setEnable:NO];，作用是在当前页面禁用IQKeyboardManager。
在 UdeskChatViewController 的 viewWillDisappear 方法中加入 [[IQKeyboardManager sharedManager] setEnable:YES];，作用是在离开当前页面之前重新启用IQKeyboardManager。

指定客服组或者客服分配出现与指定客服组客服不一致的情况

首先要确认客服没有关闭会话。

我们产品的逻辑：假设客户A选择了客服组B下的客服B1进行会话。之后客户A退出会话界面，进入另外界面，之后通过客服组C下的客服C1分配会话：这时后台会判断，如果和B1会话还存在，则会直接分配给B1，而不会分配给客服C1。只有B1会话关闭了，才会分配给客服C1。

出现在不同客户分配的会话在一个会话中

出现这种情况，是因为客服传递的sdktoken值相同。sdktoken类似于身份证，是用户的唯一标识。让客户检查接入时传入的sdktoken值。

如果设置了email或者cellphone相同，也会出现在一个客服的会话中。

八、更新记录

更新记录：

SDK v3.6.3版本更新功能

1.优化自定义字段调用方式

2.欢迎语bug修改

SDK v3.6.2版本更新功能

1.增加IM页面返回回调API

2.录音优化

SDK v3.6.1版本更新功能

1.满意度调查多次弹窗bug修改

2.客服繁忙到上线SDK弹窗自动隐藏

SDK v3.6版本更新功能

1.支持结构化消息展示

2.支持管理员端黑名单留言提示语自定义

SDK v3.5.8版本更新功能

1.支持留言添加附件

2.开放留言页面跳转方式事件逻辑修改

3.推送例子

4.bug修复

SDK v3.5.7版本更新功能

1.支持bitcode

SDK v3.5.6版本更新功能

1.修改复制大量文字到输入框引起的crash

SDK v3.5.5版本更新功能

1.支持将未读消息标记为已读

2.修复关闭会话之后有几率性不弹满意度调查

SDK v3.5.4版本更新功能

1.适配iOS10.3

SDK v3.5.3版本更新功能

1.支持管理员端SDK配置

2.支持放弃排队

3.初始化不再支持单点登录的key，统一使用创建每个应用时生成对应的appid，和appkey。

SDK v3.4版本更新功能

1.支持推送

2.支持多app

3.新增查看客户是否正在会话API

4.满意度调查bug修复

SDK v3.3.4版本更新功能

1.优化相册、语音权限流程

2.转接优化

SDK v3.3.3版本更新功能：

1.支持主动满意度调查

2.push接口增加完成回调

3.文字过多时计算bug修复

4.支持https

UDTestSDK 3.6.3

UDTestSDK 3.6.3

UDTestSDK 3.6.3

UdeskSDK-iOS

目录

一、SDK工作流程

二、导入SDK依赖的框架

2.1文件介绍

2.2引入依赖库

2.3将SDK添加到您的工程

2.4权限问题

三、快速集成SDK

3.1初始化Udesk SDK

注意：appKey、appID、domain都是必填字段。

3.2初始化客户信息

3.3 推出聊天页面

3.4 推出帮助中心

四、Udesk SDK 自定义配置

4.1 使用SDK提供的UI

原生

经典

4.2 自定义UI

4.3 指定客服ID

4.4 指定客服组ID

4.5 设置用户头像

4.6 设置SDK语言

4.7 设置放弃排队类型

4.8 自定义留言界面

注意：如果你自定义的留言界面是h5的，恰好你们有上传附件的功能，这时候你们需要添加以下代码到你们自定义的控制器，否则选择附件的时候会直接返回到上一页

五、消息推送

设置接收推送的服务器地址

上传设备的 deviceToken

通知 Udesk 服务端发送消息至开发者的服务端

关闭 Udesk 推送

离线推送接口要求

注意：如果你不使用推送

，请将app切换到后台后调用以下接口

，请在切换到前台后调用以下接口

六、Udesk SDK API说明

6.1初始化SDK

6.2初始化客户信息

6.2.1添加客户自定义字段

6.2.3更新用户信息

6.3添加咨询对象

示例

6.4请求分配客服

6.5指定分配客服

6.6指定分配客服组

6.7断开与Udesk服务器连接

6.8设置客户上线

6.8设置客户离线

6.9设置接收消息代理

6.10发送消息

6.11输入预知

6.12获取客户本地聊天数据

6.13监听收到未读消息的广播

6.14获取未读消息数量

6.15获取未读消息

6.16获取机器人URL

6.17判断客户是否正在会话

6.18将所有未读消息设置为已读

七、常见问题

键盘弹起后输入框和键盘之间有偏移

指定客服组或者客服分配出现与指定客服组客服不一致的情况

出现在不同客户分配的会话在一个会话中

八、更新记录

更新记录：