语言设置

更新时间: 2023/07/21 06:56:54

IM UIKit 的默认语言为中文,您可以通过配置参数本地化应用中的语言。

配置参数

localeConfig 中的字符串本地化为目标语言。以另一种语言显示文本,覆盖 localeConfig 中的默认值。

const LocaleConfig = {
  // 公共部分
  saveText: '保存',
  setText: '设置',
  saveSuccessText: '保存成功',
  saveFailedText: '保存失败',
  addFriendSuccessText: '添加好友成功',
  addFriendFailedText: '添加好友失败',
  okText: '确定',
  cancelText: '取消',
  deleteText: '删除',
  recallText: '撤回',
  you: '你',
  deleteFriendText: '删除好友',
  confirmDeleteText: '确定删除?',
  confirmDeleteFriendText: '确定删除好友?',
  deleteFriendSuccessText: '删除好友成功',
  deleteFriendFailedText: '删除好友失败',
  blackSuccessText: '拉黑成功',
  blackFailedText: '拉黑失败',
  removeBlackSuccessText: '解除拉黑成功',
  removeBlackFailedText: '解除拉黑失败',
  maxSelectedText: '最多只能选择',
  selectedText: '已选',
  friendsText: '位好友',
  emailErrorText: '邮箱格式不正确',
  uploadLimitText: '图片或文件大小最大支持',
  uploadLimitUnit: 'M',
  uploadImgFailedText: '上传图片失败',
  accountText: '账号',
  nickText: '昵称',
  genderText: '性别',
  phoneText: '手机',
  emailText: '邮箱',
  signText: '签名',
  accountPlaceholder: '请输入账号',
  nickPlaceholder: '请输入昵称',
  genderPlaceholder: '请选择性别',
  phonePlaceholder: '请输入手机号',
  emailPlaceholder: '请输入邮箱',
  signPlaceholder: '请输入签名',
  searchInputPlaceholder: '搜索好友或群组',
  man: '男',
  woman: '女',
  unknow: '未知',
  welcomeText: '欢迎使用云信',
  notSuportMessageText: '暂不支持该消息'

  // 会话列表组件相关
  onDismissTeamText: '群已被解散',
  onRemoveTeamText: '您已被移出群聊',
  textMsgText: '文本消息',
  audioMsgText: '音频消息',
  videoMsgText: '视频消息',
  fileMsgText: '文件消息',
  callMsgText: '话单消息',
  geoMsgText: '地理位置消息',
  imgMsgText: '图片消息',
  notiMsgText: '通知消息',
  robotMsgText: '机器消息',
  tipMsgText: '提示消息',
  unknowMsgText: '未知消息',
  deleteSessionText: '删除会话',
  muteSessionText: '开启免打扰',
  unmuteSessionText: '取消免打扰',

  // 通讯录组件相关
  teamListTitle: '我的群组',
  friendListTitle: '我的好友',
  blackListTitle: '黑名单',
  blackListDesc: '(你不会收到列表中任何联系人的消息)',
  teamMenuText: '我的群组',
  friendMenuText: '我的好友',
  blackMenuText: '黑名单',

  // 搜索组件相关
  addFriendText: '添加好友',
  createTeamText: '创建群组',
  joinTeamText: '加入群组',
  addButtonText: '添加',
  addSuccessText: '添加成功',
  addFailedText: '添加失败',
  createButtonText: '创建',
  createTeamSuccessText: '创建群组成功',
  createTeamFailedText: '创建群组失败',
  chatButtonText: '去聊天',
  getRelationFailedText: '获取关系失败',
  accountNotMatchText: '查无此账号',
  searchButtonText: '查找',
  searchTeamPlaceholder: '请输入群名称',
  teamTitle: '群名称',
  teamAvatarText: '群头像',
  addTeamMemberText: '添加成员',
  searchEmptyText: '暂无搜索结果',
  searchFriendTitle: '好友',
  searchTeamTitle: '群组',

  // 会话消息相关
  sendToText: '发送给',
  sendUsageText: '(按住enter直接发送,shift+enter换行)',
  sendEmptyText: '不能发送空白消息',
  teamMutePlaceholder: '当前群主设置为禁言',
  enterTeamText: '进入了群聊',
  leaveTeamText: '离开了群聊',
  teamMuteText: '群禁言',
  muteAllTeamText: '开启全员禁言',
  unmuteAllTeamText: '结束全员禁言',
  muteAllTeamFailedText: '禁言失败',
  updateTeamSuccessText: '修改成功',
  updateTeamFailedText: '修改失败',
  leaveTeamSuccessText: '已成功退出此群',
  leaveTeamFailedText: '退出此群失败',
  dismissTeamFailedText: '群解散失败',
  addTeamMemberFailedText: '添加成员失败',
  addTeamMemberConfirmText: '请选择要添加的群成员!',
  removeTeamMemberText: '移除成员',
  removeTeamMemberConfirmText: '移除该成员',
  removeTeamMemberFailedText: '移除成员失败',
  teamTitleConfirmText: '群名称不能为空',
  teamAvatarConfirmText: '群头像不能为空',
  teamIdText: '群ID',
  teamSignText: '群介绍',
  teamTitlePlaceholder: '请输入群名称',
  teamSignPlaceholder: '请输入内容',
  teamOwnerText: '群主',
  teamManagerText: '管理员',
  teamManagerLimitText: '仅管理员可修改群资料',
  teamMemberText: '群成员',
  teamInfoText: '群资料',
  teamPowerText: '权限设置',
  dismissTeamText: '解散群聊',
  dismissTeamConfirmText: '是否确认解散该群聊',
  leaveTeamTitle: '离开群聊',
  leaveTeamConfirmText: '是否确认退出该群聊',
  personUnit: '人',
  leaveTeamButtonText: '删除并退出',
  sendStrangerFailedText: '消息发送失败,请确认是否是好友',
  sendBlackFailedText: '您已被对方拉入黑名单',
  recallMessageText: '撤回了一条消息',
  reeditText: '重新编辑',
  addChatMemberText: '添加聊天成员',
  chatHistoryText: '聊天记录',
}

设置本地化语言

import React from 'react'
import { Provider } from '@xkit-yx/im-kit-ui'

const App = () => {
  const initOptions = {
    appkey: '',
    account: '',
    token: '',
    debugLevel: 'debug',
    // ……
  }

  const localeConfig = {
    welcomeText: 'Welcome to use IM UI KIT.',
    saveText: 'Save',
    saveSuccessText: 'Save success.',
    addFriendSuccessText: 'Add friend success.',
  }

  return (
    <Provider
      initOptions={initOptions}
      sdkVersion={2}
      localeConfig={localeConfig}
    >
      <div className="app">……</div>
    </Provider>
  )
}
此文档是否对你有帮助?
有帮助
去反馈
  • 配置参数
  • 设置本地化语言