跳到主要内容

SendClientMessagef

注意

这个函数是在open.mp beta build 6中添加的,在以前的版本中不起作用!

注意

此函数已被弃用

SendClientMessage 函数现已内置格式化功能

描述

向指定玩家发送格式化的彩色聊天信息。整行文字将使用设定颜色显示,除非使用颜色嵌入功能。

参数名说明
playerid接收信息的玩家 ID
color信息颜色(0xRRGGBBAA 十六进制格式)
const message[]显示文本(最大 144 字符)
{Float, _}:...不定数量的任意标签类型参数

返回值

1: 函数执行成功(超过 144 字符的字符串会返回成功但信息不会被发送)

0: 函数执行失败(玩家未连接)

格式说明符

说明符含义
%i无符号整数
%d有符号整数
%s字符串
%f浮点数
%cASCII 字符
%x十六进制数
%b二进制数
%%百分号字面量
%q转义 SQLite 文本(0.3.7 R2 版本新增)

示例代码

#define COLOR_RED 0xFF0000FF

public OnPlayerConnect(playerid)
{
new number = 5;
SendClientMessagef(playerid, -1, "上方变量的值为 %i", number);
return 1;
}

注意事项

提示
  • 可使用颜色嵌入实现多色文本效果
  • 使用-1 作为颜色值时文本将显示为白色(十六进制表示为 0xFFFFFFFF)
注意
  • 超过 144 字符的信息不会被发送,可使用截断或分多行显示解决
  • SA-MP 官方客户端最大支持 144 字节(包括格式说明符转换后的字符)