Закрыть

Ток получение параметры: Как найти силу тока с помощью формул и измерительных приборов

Содержание

Постоянный ток. Определение и параметры

Постоянный ток (DC — Direct Current) — электрический ток, не меняющий своей величины и направления с течением времени.

В реальности постоянный ток не может сохранять величину постоянной. Например, на выходе выпрямителей всегда присутствует переменная составляющая пульсаций. При использовании гальванических элементов, батареек или аккумуляторов, величина тока будет уменьшаться по мере расхода энергии, что актуально при больших нагрузках.

Постоянный ток существует условно в тех случаях, где можно пренебречь изменениями его постоянной величины.

Постоянная составляющая тока и напряжения. DC

Если рассмотреть форму тока в нагрузке на выходе выпрямителей или преобразователей, можно увидеть пульсации — изменения величины тока, существующие, как результат ограниченных возможностей фильтрующих элементов выпрямителя.
В некоторых случаях величина пульсаций может достигать достаточно больших значений, которые нельзя не учитывать в расчётах, например, в выпрямителях без применения конденсаторов.

Такой ток обычно называют пульсирующим или импульсным. В этих случаях следует рассматривать постоянную DC и переменную AC составляющие.

Постоянная составляющая DC — величина, равная среднему значению тока за период.

AVG — аббревиатура Avguste — Среднее.

Переменная составляющая AC — периодическое изменение величины тока, уменьшение и увеличение относительно среднего значения .

Следует учитывать при расчётах, что величина пульсирующего тока будет равна не среднему значению, а квадратному корню из суммы квадратов двух величин — постоянной составляющей (DC) и среднеквадратичного значения переменной составляющей (AC), которая присутствует в этом токе, обладает определённой мощностью и суммируется с мощностью постоянной составляющей.

Вышеописанные определения, а так же термины AC и DC могут быть использованы в равной степени как для тока, так и для напряжения .

Отличие постоянного тока от переменного

По ассоциативным предпочтениям в технической литературе импульсный ток часто называют постоянным, так как он имеет одно постоянное направление. В таком случае необходимо уточнять, что имеется в виду постоянный ток с переменной составляющей.
А иногда его называют переменным, по той причине, что периодически меняет величину. Переменный ток с постоянной составляющей.
Обычно берут за основу составляющую, которая больше по величине или которая наиболее значима в контексте.

Следует помнить, что постоянный ток или напряжение характеризует, кроме направления, главный критерий — постоянная его величина, которая служит основой физических законов и является определяющей в расчётных формулах электрических цепей.
Постоянная составляющая DC, как среднее значение, является лишь одним из параметров переменного тока.

Для переменного тока (напряжения) в большинстве случаев бывает важен критерий — отсутствие постоянной составляющей, когда среднее значение равно нулю.

Это ток, который протекает в конденсаторах, силовых трансформаторах, линиях электропередач. Это напряжение на обмотках трансформаторов и в бытовой электрической сети.
В таких случаях постоянная составляющая может существовать только в виде потерь, вызванных нелинейным характером нагрузок.

Параметры постоянного тока и напряжения

Сразу следует отметить, что устаревший термин «сила тока» в современной отечественной технической литературе используется уже нечасто и признан некорректным. Электрический ток характеризует не сила, а скорость и интенсивность перемещения заряженных частиц. А именно, количество заряда, прошедшее за единицу времени через поперечное сечение проводника.
Основным параметром для постоянного тока является величина тока.

Единица измерения тока — Ампер.
Величина тока 1 Ампер — перемещение заряда 1 Кулон за 1 секунду.

Единица измерения напряжения — Вольт.
Величина напряжения 1 Вольт — разность потенциалов между двумя точками электрического поля, необходимая для совершения работы 1 Джоуль при прохождения заряда 1 Кулон.

Для выпрямителей и преобразователей часто бывает важными следующие параметры для постоянного напряжения или тока:

Размах пульсаций напряжения (тока) — величина, равная разности между максимальным и минимальным значениями.
Коэффициент пульсаций — величина, равная отношению действующего значения переменной составляющей AC напряжения или тока к его постоянной составляющей DC.

Похожие статьи: Параметры переменного тока.


Замечания и предложения принимаются и приветствуются!

преимущества и недостатки ⋆ diodov.net

Какой электрический ток лучше: постоянный или переменный ток? Чтобы дать ответ на данный вопрос нужно оценить их преимущества и недостатки по следующим основным направлениям: выработка, передача, распределение и потребление электроэнергии. Проще говоря, нужно ответить на следующие вопросы. Какой род тока проще и дешевле получить, затем передать его на большое расстояние, после чего распределить электроэнергию между потребителями. Потребители какого рода энергии более эффективны?

Сегодня преимущественное большинство электрической энергии, добываемой или генерируемой в мире, выпадет на переменный ток. И в первую очередь это связано с тем, что переменный ток проще преобразовывать из более низкого напряжения в более высокое и наоборот, то есть он проще в трансформации.

Место производство электрической энергии большой мощности, к сожалению пока что невозможно базировать в тех местах, где хотелось бы, то есть непосредственно рядом с потребителями. Например, мощную гидроэлектростанцию можно соорудить только на полноводной реке и то не в каждом месте. А конечный потребитель может находиться на расстоянии сотни и тысячи километров от электростанции. Поэтому очень важно обеспечить такие условия, чтобы минимизировать потери мощности в проводах линии электропередачи ЛЭП. В этом случае потери электроэнергии снижаются с ростом напряжения. Давайте остановимся на этом более подробно. Предположим, имеется некая электростанция, а точнее ее генератор, выдающий мощность 1000 кВт и нам необходимо передать эту мощность потребителю, который находится на расстоянии, например на 100 км от генератора.

Для сравнения электрическую энергию будем передавать напряжением 10 кВ и 100 кВ. При заданных мощности и напряжениях определим величины токов, протекающих в проводах.

I1 = P/U1 = 1000 кВт/10 кВ = 100 А.

I2 = P/U2 = 1000 кВт/100 кВ = 10 А.

Как мы видим, при увеличении напряжения в 10 раз, ток снижается тоже в 10 раз.

Потери электроэнергии в проводах ЛЭП и не только в них определяются квадратом тока, протекающего в них и сопротивлением самого провода. Для простоты расчет примем сопротивление проводов, равным 10 Ом. Подсчитаем потери мощности для обоих случаев.

Pпот1 = I12∙R = 1002∙10 = 100000 Вт = 100 кВт.

Pпот2 = I22∙R = 102∙10 = 1000 Вт = 1 кВт.

Теперь, как мы видим, с ростом напряжения в 10 раз потери электроэнергии снижаются в 100 раз! При более низком напряжении доля потерь в проводах составляет 10 % от мощности, выдаваемой генератором. А при более высоком напряжении эта доля составляет всего 0,1 %. Поэтому очень важным параметров сравнения родов тока является возможность повышать напряжение, а затем его снижать в конечных пунктах.

Можно было бы и не повышать напряжение, а для снижения потерь применять более толстые провода, но такой подход экономически не оправдан, поскольку медные провода стоят денег.

Также можно было бы и не повышать напряжение генератора, а создать такой генератор, который сразу бы выдавал высокое напряжения. Но здесь возникают сложности при изготовлении таких генераторов. Сложности связаны в основном с изоляцией высоковольтных элементов генератора. Короче говоря, изготовить трансформатор на высокое напряжение гораздо проще и дешевле, нежели генератор.

Преимущества переменного тока

Вопрос повышения и снижения переменного напряжения при нынешнем уровне технического развития решается гораздо проще, чем постоянного электрического тока.

Такие преобразования довольно просто выполняются с помощью относительно простого устройства – трансформатора. Трансформатор обладает высоким коэффициентом полезного действия, который достигает 99 %. Это значит, что не более одного процента мощности теряется при повышении или снижении напряжения. К тому же трансформатор позволяет развязать высокое напряжение с более низким, что для большинства электроустановок является очень весомым аргументом.

Применение трехфазной системы переменного тока позволяет еще больше повысить эффективность системы электроснабжения. Для передачи электричества аналогичной мощности потребуется меньше проводов, чем при однофазном переменном токе. К тому же трехфазный трансформатор меньше габаритов однофазного трансформатора равной мощности.

Электрические машины переменного тока, в частности асинхронные двигатели с короткозамкнутым ротором имеют гораздо проще конструкцию, чем двигатели постоянного тока. Главным преимуществом трехфазных асинхронных двигателей является отсутствие коллекторно-щеточного узла. Благодаря чему снижаются расходы на изготовление и эксплуатацию таких электрических машин. Кроме того за счет отсутствия коллекторно-щеточного узла асинхронные двигатели имеют в разы большую мощность по сравнению с двигателями постоянного тока.

Недостатки постоянного тока

Из выше изложенного следуют такие недостатки.

  1. Сложность повышения и снижения напряжения, то есть преобразования электроэнергии постоянного тока. В первую очередь это вызвано сложность конструкций преобразователей. Поскольку необходимы мощные полупроводниковые ключи, рассчитанные на высокое напряжение. Отсутствие которых приводит к большому числу последовательно и параллельно соединенных полупроводниковых приборов. В результате снижается надежность всего преобразователя, увеличивается стоимость и возрастают потери мощности.
  2. Электрические машины имеют более сложную конструкцию, поэтому менее надежны и более затратные, как в производстве, так и в эксплуатации.
  3. Сложности в развязке высокого и низкого напряжений.

Недостатки переменного тока

  1. Важнейшим недостатком переменного тока является наличие реактивной мощности. Как известно, конденсатор и катушка индуктивности проявляют свои реактивные свойства только в цепях переменного тока. Проще говоря, катушка и конденсатор создают реактивное сопротивление переменному току, но не потребляю его. В результате этого из полной мощности, отдаваемой генератором переменного тока, часть мощности не затрачивается на выполнение полезной работы, а лишь бесполезно циркулирует межу генератором и нагрузкой. Такая мощность называется реактивной и является вредной. Поэтому ее стараются минимизировать.

Однако большинство нагрузок – двигатели, трансформаторы и сами провода являются индуктивными элементами. А чем больше индуктивность, тем большую долю составляет реактивная мощность от полной и с этим нужно бороться.

  1. Второй главный недостаток переменного тока заключается в том, что он протекает не по всему сечению проводника, а вытесняется ближе к его поверхности. В результате снижается площадь, по которой протекает электрический ток, что в свою очередь приводит к увеличению сопротивления проводника и к росту потерь мощности в нем.

Чем выше частота, тем сильнее вытесняется ток к поверхности проводника и в конечном счете, тем выше потери мощности.

Преимущества постоянного тока

  1. Главное преимущество электрической энергии постоянного тока – это отсутствие реактивной мощности. А это значит, что вся мощность, выработанная генератором, потребляется нагрузкой за вычетом потерь в проводах.
  2. Постоянный ток в отличие от переменного протекает по всему сечению проводника.

Указанные два пункта приводят к тому, что если передавать одну и ту же мощность при равных напряжениях постоянным и переменным токами, то потери мощности электроэнергии постоянным током были бы почти в два раза меньше, чем при переменном токе.

К тому же, если рассматривать такие бытовые электронные устройства как ноутбуки, компьютеры, телевизоры и т. п., то все они имеют блоки питания, преобразующие переменное напряжение 220 В (230 В) в постоянное напряжение более низкой величины. А такие преобразования связаны с частичной потерей мощности.

Кроме того, как было сказано ранее, трехфазный асинхронный двигатель (АД) можно подключить напрямую к сети 380 В, что вполне оправдано в том случае, когда не требуется изменять режим работы двигателя. Но если необходимо изменять частоту вращения его вала, то нужно на обмотки статора подавать напряжение, частота и амплитуда которого должны изменяться пропорционально, согласно закону Костенка. Для этого применяют трехфазные автономные инверторы (АИ), чаще всего инверторы напряжения. Такие инверторы должны получать питание от источника постоянного напряжения.

 

Также следует заметить, что последним временем начали очень широко применяться солнечные батареи, которые вырабатывают постоянный ток. К тому же, значительно возросла мощность аккумуляторных батарей и повысилась емкость суперконденсаторов, которые также относятся к источникам постоянного тока и с каждым днем находят все большее практическое применение.

Выводы: постоянный или переменный ток

Несмотря на все преимущества постоянного тока, значительная сложность, вызванная преобразованием больших мощностей, главным образом сказывается сложность повышения и понижения постоянного напряжения, сводит на нет указанные выше преимущества. Поэтому, до тех пор, пока не будут разработаны полупроводниковые ключи огромной мощности и соответствующие преобразователи на их основе, переменный ток остается вне конкуренции. К тому же сейчас уже применяются четырехквадрантные преобразователи или активные выпрямители, позволяющие скомпенсировать реактивную составляющую нагрузки, что позволяет получить коэффициент мощности, равный почти единице. Благодаря чему исключается потребление реактивной мощности.

Как вы видите, однозначного ответа на вопрос, какой ток лучше: постоянный или переменный, не существует. Следует сравнивать все преимущества и недостатки для конкретного случая.

Еще статьи по данной теме

Основные параметры переменного тока

При подключении к источнику переменного тока с синусоидально изменяющейся э. д. с. электрических цепей с линейными сопротивлениями в них будут действовать синусоидально изменяющиеся напряжения и проходить синусоидально изменяющиеся токи. Переменные токи, э. д. с. и напряжения характеризуются четырьмя основными параметрами: периодом, частотой, амплитудой и действующим значением.

Период.Промежуток времени , в течение которого э. д. с, напряжение и или ток совершают полный цикл изменений, называется периодом. Чем быстрее вращается виток или ротор генератора переменного тока, тем меньше период изменения э. д. с. или тока.

Частота.Число полных периодов изменения э. д. с, напряжения или тока в 1 с называется частотой,

f = 1 / T

Она измеряется в герцах (Гц), т. е. числом периодов в секунду. Чем больше частота, тем меньше период изменения тока, напряжения или э. д. с. . В Советском Союзе все электрические станции переменного тока вырабатывают ток, изменяющийся с частотой 50 Гц, т. е. 50 периодов в секунду. В автоматике и радиотехнике применяют электрические токи и более высоких частот. Такие частоты измеряются в килогерцах (1 кГц=103 Гц) и мегагерцах (1 МГц=106 Гц).

Амплитуда.Наибольшее значение переменного тока (переменных э. д. с. и напряжения) называют амплитудным значением, или амплитудой.

Действующее значение. Ток, напряжение и э. д. с, действующие в электрической цепи в каждый отдельный момент времени, определяются так называемыми мгновенными значениями.Однако судить о переменных э. д. с, токе или напряжении по их мгновенным значениям неудобно, так как эти значения непрерывно меняются. Поэтому оценивать способность переменного тока совершать механическую работу или создавать тепло принято по действующему его значению. Под действующим значением переменного тока понимают силу такого постоянного тока , который, проходя по проводнику в течение некоторого времени, выделит в нем такое же количество тепла, как и данный переменный ток .Действующие значения тока, напряжения и э. д. с. обозначают соответственно I, U, Е.

 

19.Действующим (эффективным) значением силы переменного тока называют величину постоянного тока, действие которого произведёт такую же работу (тепловой или электродинамический эффект), что и рассматриваемый переменный ток за время одного периода. В современной литературе чаще используется математическое определение этой величины — среднеквадратичное значение силы переменного тока.

Иначе говоря, действующее значение тока можно определить по формуле:

.

Для гармонических колебаний тока

Аналогичным образом определяются действующие значения ЭДС и напряжения.

 

 

21. АКТИВНОЕ СОПРОТИВЛЕНИЕ В ЦЕПИ ПЕРЕМЕННОГО ТОКА

Сопротивление, включенное в цепь переменного тока, в котором происходит превращение электрической энергии в полезную рабо­ту или в тепловую энергию, называется активным сопротивлением.

К активным сопротивлениям при промышленной частоте (50 гц) относятся, например, электрические лампы накаливания и электро­нагревательные устройства.

 

Рассмотрим цепь переменного тока (рис. 53), в которую вклю­чено активное сопротивление. В такой цепи под действием перемен­ного напряжения протекает переменный ток. Изменение тока в Цепи, согласно закону Ома, зависит только от изменения напряже­ния, подключенного к ее зажимам. Когда напряжение равно нулю, ток в цепи также равен нулю. По мере увеличения напряжения ток в Цепи возрастает и при максимальном значении напряжения ток становится наибольшим. При уменьшении напряжения ток убывает. Когда напряжение изменяет свое направление, ток также изменяет свое направление и т. д.

Из сказанного следует, что в цепи переменного тока с актив­ным сопротивлением по мере изменения по величине и направлению напряжения одновременно пропорционально меняются величина и Направление тока. Это значит, что ток и напряжение совпадают по фазе.

Построим векторную диаграмму действующих величин тока и напряжения для цепи с активным сопротивлением. Для этого отлов жим в выбранном масштабе по горизонтали вектор напряжения Чтобы на векторной диаграмме показать, что напряжение и ток в цепи совпадают по фазе (j=0), откладываем вектор тока I по направлению вектора напряжения.

Сила тока в такой цепи определяется по закону Ома:

 

В этой цепи среднее значение мощности, потребляемой активным сопротивлением, выражается произведением действующих значения тока и напряжения.

 

24.

Емкостное сопротивление в цепи переменного тока
При включении конденсатора в цепь постоянного напряже­ния сила тока I=0, а при включении конденсатора в цепь пере­менного напряжения сила тока I ? 0. Следовательно, конденса­тор в цепи переменного напряжения создает сопротивление меньше, чем в цепи постоянного тока.
Мгновенное значение напряжения равно . Мгновенное значение силы тока равно: Таким образом, колебания напряжения отстают от колебаний тока по фазе на π/2.
Т.к. согласно закону Ома сила тока прямо пропорциональна напряжению, то для максимальных значений тока и напряжения получим: , где — емкостное сопротивление.
Емкостное сопротивление не является характеристикой проводника, т.к. зависит от параметров цепи (частоты).
Чем больше частота переменного тока, тем лучше пропускает конденсатор ток (тем меньше сопротивление конденсатора переменному току).
Т.к. разность фаз между колебаниями тока и напряжения равна π/2, то мощность в цепи равна 0: энергия не расходуется, а происходит обмен энергией между источником напряжения и емкостной нагрузкой. Такая нагрузка наз. реактивной.  
22. Индуктивное сопротивление в цепи переменного тока
В катушке, включенной в цепь переменного напряжения, си­ла тока меньше силы тока в цепи постоянного напряжения для этой же катушки. Следовательно, катушка в цепи переменного напряжения создает большее сопротивление, чем в цепи посто­янного напряжения.
Мгновенное значение силы тока:
Мгновенное значение напряжения можно установить, учиты­вая, что u = — εi, где u – мгновенное значение напряжения, а εi – мгновенное значение эдс самоиндукции, т. е. при изменении тока в цепи возникает ЭДС самоиндукции, которая в соответствии с законом электромагнитной индукции и правилом Ленца равна по величине и противоположна по фазе приложенному напряжению.  
. Следовательно , где амплитуда напряжения. Напряжение опережает ток по фазе на π/2.
Т.к. согласно закону Ома сила тока прямо пропорциональна напряжению и обратно пропорциональная сопротивлению, то приняв величину ωL за сопротивление катушки переменному току, получим: — закон Ома для цепи с чисто индуктивной нагрузкой.
Величина — индуктивное сопротивление.
Т.о. в любое мгновение времени изменению силы тока противодействует ЭДС самоиндукции. ЭДС самоиндукции — причина индуктивного сопротивления.
В отличие от активного сопротивления, индуктивное не является характеристикой проводника, т.к. зависит от параметров цепи (частоты): чем больше частота переменного тока, тем больше сопротивление, которое ему оказывает катушка.  
Т.к. разность фаз между колебаниями тока и напряжения равна π/2, то мощность в цепи равна 0: энергия не расходуется, а происходит обмен энергией между источником напряжения и индуктивной нагрузкой. Такая нагрузка наз. реактивной.  

 

25. Резонанс напряжений — резонанс, происходящий в последовательном колебательном контуре при его подключении к источнику напряжения, частота которого совпадает с собственной частотой контура.

Описание явления:

Пусть имеется колебательный контур с частотой собственных колебаний f, и пусть внутри него работает генератор переменного тока такой же частоты f.

В начальный момент конденсатор контура разряжен, генератор не работает. После включения напряжение на генераторе начинает возрастать, заряжая конденсатор. Катушка в первое мгновение не пропускает ток из-за ЭДС самоиндукции. Напряжение на генераторе достигает максимума, заряжая до такого же напряжения конденсатор.

Далее: конденсатор начинает разряжаться на катушку. Напряжение на нем падает с такой же скоростью, с какой уменьшается напряжение на генераторе.

Далее: конденсатор разряжен до нуля, вся энергия электрического поля, имевшаяся в конденсаторе, перешла в энергию магнитного поля катушки. На клеммах генератора в этот момент напряжение нулевое.

Далее: так как магнитное поле не может существовать стационарно, оно начинает уменьшаться, пересекая витки катушки в обратном направлении. На выводах катушки появляется ЭДС индукции, которое начинает перезаряжать конденсатор. В цепи колебательного контура течет ток, только уже противоположно току заряда, так как витки пересекаются полем в обратном направлении. Обкладки конденсатора перезаряжаются зарядами, противоположными первоначальным. Одновременно растет напряжение на генераторе противоположного знака, причем с той же скоростью, с какой катушка заряжает конденсатор.)

Далее: катушка перезарядила конденсатор до максимального напряжения. Напряжение на генераторе к этому моменту тоже достигло максимального.

Возникла следующая ситуация. Конденсатор и генератор соединены последовательно и на обоих напряжение, равное напряжению генератора. При последовательном соединении источников питания их напряжения складываются.

Следовательно, в следующем полупериоде на катушку пойдет удвоенное напряжение (и от генератора, и от конденсатора), и колебания в контуре будут происходить при удвоенном напряжении на катушке.

В контурах с низкой добротностью напряжение на катушке будет ниже удвоенного, так как часть энергии будет рассеиваться (на излучение, на нагрев) и энергия конденсатора не перейдет полностью в энергию катушки). Соединены как бы последовательно генератор и часть конденсатора.

 

 

27. Коэффицие́нт мо́щности — безразмерная физическая величина, характеризующая потребителя переменного электрического тока с точки зрения наличия в нагрузке реактивной составляющей. Коэффициент мощности показывает, насколько сдвигается по фазе переменный ток, протекающий через нагрузку, относительно приложенного к ней напряжения.

Численно коэффициент мощности равен косинусу этого фазового сдвига.

Можно показать, что если источник синусоидального тока (например, розетка ~220 В, 50 Гц) нагрузить на нагрузку, в которой ток опережает или отстаёт по фазе на некоторый угол от напряжения, то на внутреннем активном сопротивлении источника выделяется повышенная мощность. На практике это означает, что при работе на нагрузку со сдвинутыми напряжением и током от электростанции требуется больше энергии; избыток передаваемой энергии выделяется в виде тепла в проводах и может быть довольно значительным.

Равен отношению потребляемой электроприёмником активной мощности к полной мощности. Активная мощностьрасходуется на совершение работы. Полная мощность — геометрическая сумма активной и реактивной мощностей (в случае синусоидальных тока и напряжения). В общем случае полную мощность можно определить как произведение действующих (среднеквадратических) значений тока и напряжения в цепи. Полная мощность равна корню квадратному из суммы квадратов активной и неактивной мощностей. В качестве единицы измерения полной мощности принято использовать вольт-ампер (В∙А) вместо ватта (Вт).

Согласно неравенству Коши—Буняковского, активная мощность, равная среднему значению произведения тока и напряжения, всегда не превышает произведение соответствующих среднеквадратических значений. Поэтому коэффициент мощности принимает значения от нуля до единицы (то есть от 0 до 100 %).

Коэффициент мощности математически можно интерпретировать как косинус угла между векторами тока и напряжения. Поэтому в случае синусоидальных напряжения и тока величина коэффициента мощности совпадает с косинусом угла, на который отстают соответствующие фазы.

В электроэнергетике для коэффициента мощности приняты обозначения cos φ (где φ — сдвиг фаз между силой токаи напряжением) либо λ. Когда для обозначения коэффициента мощности используется λ, его величину обычно выражают в процентах.

При наличии реактивной составляющей в нагрузке кроме значения коэффициента мощности иногда также указывают характер нагрузки: активно-ёмкостный или активно-индуктивный. В этом случае коэффициент мощности соответственно называют опережающим или отстающим.

В случае синусоидального напряжения, если нагрузка не имеет реактивной составляющей, коэффициент мощности равен доле мощности первой гармоники тока в полной мощности, потребляемой нагрузкой, и равен коэффициенту искажений тока.


Читайте также:


Рекомендуемые страницы:

Поиск по сайту

Принцип работы диода. Вольт-амперная характеристика. Пробои p-n перехода

Здравствуйте уважаемые читатели сайта sesaga.ru. В первой части статьи мы с Вами разобрались, что такое полупроводник и как возникает в нем ток. Сегодня мы продолжим начатую тему и поговорим о принципе работы полупроводниковых диодов.

Диод – это полупроводниковый прибор с одним p-n переходом, имеющий два вывода (анод и катод), и предназначенный для выпрямления, детектирования, стабилизации, модуляции, ограничения и преобразования электрических сигналов.

По своему функциональному назначению диоды подразделяются на выпрямительные, универсальные, импульсные, СВЧ-диоды, стабилитроны, варикапы, переключающие, туннельные диоды и т.д.

Теоретически мы знаем, что диод в одну сторону пропускает ток, а в другую нет. Но как, и каким образом он это делает, знают и понимают не многие.

Схематично диод можно представить в виде кристалла состоящего из двух полупроводников (областей). Одна область кристалла обладает проводимостью p-типа, а другая — проводимостью n-типа.

На рисунке дырки, преобладающие в области p-типа, условно изображены красными кружками, а электроны, преобладающие в области n-типа — синими. Эти две области являются электродами диода анодом и катодом:

Анод – положительный электрод диода, в котором основными носителями заряда являются дырки.

Катод – отрицательный электрод диода, в котором основными носителями заряда являются электроны.

На внешние поверхности областей нанесены контактные металлические слои, к которым припаяны проволочные выводы электродов диода. Такой прибор может находиться только в одном из двух состояний:

1. Открытое – когда он хорошо проводит ток;
2. Закрытое – когда он плохо проводит ток.

Прямое включение диода. Прямой ток.

Если к электродам диода подключить источник постоянного напряжения: на вывод анода «плюс» а на вывод катода «минус», то диод окажется в открытом состоянии и через него потечет ток, величина которого будет зависеть от приложенного напряжения и свойств диода.

При такой полярности подключения электроны из области n-типа устремятся навстречу дыркам в область p-типа, а дырки из области p-типа двинутся навстречу электронам в область n-типа. На границе раздела областей, называемой электронно-дырочным или p-n переходом, они встретятся, где происходит их взаимное поглощение или рекомбинация.

Например. Oсновные носители заряда в области n-типа электроны, преодолевая p-n переход попадают в дырочную область p-типа, в которой они становятся неосновными. Ставшие неосновными, электроны будут поглощаться основными носителями в дырочной области – дырками. Таким же образом дырки, попадая в электронную область n-типа становятся неосновными носителями заряда в этой области, и будут также поглощаться основными носителями – электронами.

Контакт диода, соединенный с отрицательным полюсом источника постоянного напряжения будет отдавать области n-типа практически неограниченное количество электронов, пополняя убывание электронов в этой области. А контакт, соединенный с положительным полюсом источника напряжения, способен принять из области p-типа такое же количество электронов, благодаря чему восстанавливается концентрация дырок в области p-типа. Таким образом, проводимость p-n перехода станет большой и сопротивление току будет мало, а значит, через диод будет течь ток, называемый прямым током диода Iпр.

Обратное включение диода. Обратный ток.

Поменяем полярность источника постоянного напряжения – диод окажется в закрытом состоянии.

В этом случае электроны в области n-типа станут перемещаться к положительному полюсу источника питания, отдаляясь от p-n перехода, и дырки, в области p-типа, также будут отдаляться от p-n перехода, перемещаясь к отрицательному полюсу источника питания. В результате граница областей как бы расширится, отчего образуется зона обедненная дырками и электронами, которая будет оказывать току большое сопротивление.

Но, так как в каждой из областей диода присутствуют неосновные носители заряда, то небольшой обмен электронами и дырками между областями происходить все же будет. Поэтому через диод будет протекать ток во много раз меньший, чем прямой, и такой ток называют обратным током диода (Iобр). Как правило, на практике, обратным током p-n перехода пренебрегают, и отсюда получается вывод, что p-n переход обладает только односторонней проводимостью.

Прямое и обратное напряжение диода.

Напряжение, при котором диод открывается и через него идет прямой ток называют прямым (Uпр), а напряжение обратной полярности, при котором диод закрывается и через него идет обратный ток называют обратным (Uобр).

При прямом напряжении (Uпр) сопротивление диода не превышает и нескольких десятков Ом, зато при обратном напряжении (Uобр) сопротивление возрастает до нескольких десятков, сотен и даже тысяч килоом. В этом не трудно убедиться, если измерить обратное сопротивление диода омметром.

Сопротивление p-n перехода диода величина не постоянная и зависит от прямого напряжения (Uпр), которое подается на диод. Чем больше это напряжение, тем меньшее сопротивление оказывает p-n переход, тем больший прямой ток Iпр течет через диод. В закрытом состоянии на диоде падает практически все напряжение, следовательно, обратный ток, проходящий через него мал, а сопротивление p-n перехода велико.

Например. Если включить диод в цепь переменного тока, то он будет открываться при положительных полупериодах на аноде, свободно пропуская прямой ток (Iпр), и закрываться при отрицательных полупериодах на аноде, почти не пропуская ток противоположного направления – обратный ток (Iобр). Эти свойства диодов используют для преобразования переменного тока в постоянный, и такие диоды называют выпрямительными.

Вольт-амперная характеристика полупроводникового диода.

Зависимость тока, проходящего через p-n переход, от величины и полярности приложенного к нему напряжения изображают в виде кривой, называемой вольт-амперной характеристикой диода.

На графике ниже изображена такая кривая. По вертикальной оси в верхней части обозначены значения прямого тока (Iпр), а в нижней части — обратного тока (Iобр).
По горизонтальной оси в правой части обозначены значения прямого напряжения Uпр, а в левой части – обратного напряжения (Uобр).

Вольт-амперная характеристика состоит как бы из двух ветвей: прямая ветвь, в правой верхней части, соответствует прямому (пропускному) току через диод, и обратная ветвь, в левой нижней части, соответствующая обратному (закрытому) току через диод.

Прямая ветвь идет круто вверх, прижимаясь к вертикальной оси, и характеризует быстрый рост прямого тока через диод с увеличением прямого напряжения.
Обратная ветвь идет почти параллельно горизонтальной оси и характеризует медленный рост обратного тока. Чем круче к вертикальной оси прямая ветвь и чем ближе к горизонтальной обратная ветвь, тем лучше выпрямительные свойства диода. Наличие небольшого обратного тока является недостатком диодов. Из кривой вольт-амперной характеристики видно, что прямой ток диода (Iпр) в сотни раз больше обратного тока (Iобр).

При увеличении прямого напряжения через p-n переход ток вначале возрастает медленно, а затем начинается участок быстрого нарастания тока. Это объясняется тем, что германиевый диод открывается и начинает проводить ток при прямом напряжении 0,1 – 0,2В, а кремниевый при 0,5 – 0,6В.

Например. При прямом напряжении Uпр = 0,5В прямой ток Iпр равен 50mA (точка «а» на графике), а уже при напряжении Uпр = 1В ток возрастает до 150mA (точка «б» на графике).

Но такое увеличение тока приводит к нагреванию молекулы полупроводника. И если количество выделяемого тепла будет больше отводимого от кристалла естественным путем, либо с помощью специальных устройств охлаждения (радиаторы), то в молекуле проводника могут произойти необратимые изменения вплоть до разрушения кристаллической решетки. Поэтому прямой ток p-n перехода ограничивают на уровне, исключающем перегрев полупроводниковой структуры. Для этого используют ограничительный резистор, включенный последовательно с диодом.

У полупроводниковых диодов величина прямого напряжения Uпр при всех значениях рабочих токов не превышает:
для германиевых — 1В;
для кремниевых — 1,5В.

При увеличении обратного напряжения (Uобр), приложенного к p-n переходу, ток увеличивается незначительно, о чем говорит обратная ветвь вольтамперной характеристики.
Например. Возьмем диод с параметрами: Uобр max = 100В, Iобр max = 0,5 mA, где:

Uобр max – максимальное постоянное обратное напряжение, В;
Iобр max – максимальный обратный ток, мкА.

При постепенном увеличении обратного напряжения до значения 100В видно, как незначительно растет обратный ток (точка «в» на графике). Но при дальнейшем увеличении напряжения, свыше максимального, на которое рассчитан p-n переход диода, происходит резкое увеличение обратного тока (пунктирная линия), нагрев кристалла полупроводника и, как следствие, наступает пробой p-n перехода.

Пробои p-n перехода.

Пробоем p-n перехода называется явление резкого увеличения обратного тока при достижении обратным напряжением определенного критического значения. Различают электрический и тепловой пробои p-n перехода. В свою очередь, электрический пробой разделяется на туннельный и лавинный пробои.

Электрический пробой.

Электрический пробой возникает в результате воздействия сильного электрического поля в p-n переходе. Такой пробой является обратимый, то есть он не приводит к повреждению перехода, и при снижении обратного напряжения свойства диода сохраняются. Например. В таком режиме работают стабилитроны – диоды, предназначенные для стабилизации напряжения.

Туннельный пробой.

Туннельный пробой происходит в результате явления туннельного эффекта, который проявляется в том, что при сильной напряженности электрического поля, действующего в p-n переходе малой толщины, некоторые электроны проникают (просачиваются) через переход из области p-типа в область n-типа без изменения своей энергии. Тонкие p-n переходы возможны только при высокой концентрации примесей в молекуле полупроводника.

В зависимости от мощности и назначения диода толщина электронно-дырочного перехода может находиться в пределах от 100 нм (нанометров) до 1 мкм (микрометр).

Для туннельного пробоя характерен резкий рост обратного тока при незначительном обратном напряжении – обычно несколько вольт. На основе этого эффекта работают туннельные диоды.

Благодаря своим свойствам туннельные диоды используются в усилителях, генераторах синусоидальных релаксационных колебаний и переключающих устройствах на частотах до сотен и тысяч мегагерц.

Лавинный пробой.

Лавинный пробой заключается в том, что под действием сильного электрического поля неосновные носители зарядов под действием тепла в p-n переходе ускоряются на столько, что способны выбить из атома один из его валентных электронов и перебросить его в зону проводимости, образовав при этом пару электрон — дырка. Образовавшиеся носители зарядов тоже начнут разгоняться и сталкиваться с другими атомами, образуя следующие пары электрон – дырка. Процесс приобретает лавинообразный характер, что приводит к резкому увеличению обратного тока при практически неизменном напряжении.

Диоды, в которых используется эффект лавинного пробоя используются в мощных выпрямительных агрегатах, применяемых в металлургической и химической промышленности, железнодорожном транспорте и в других электротехнических изделиях, в которых может возникнуть обратное напряжение выше допустимого.

Тепловой пробой.

Тепловой пробой возникает в результате перегрева p-n перехода в момент протекания через него тока большого значения и при недостаточном теплоотводе, не обеспечивающем устойчивость теплового режима перехода.

При увеличении приложенного к p-n переходу обратного напряжения (Uобр) рассеиваемая мощность на переходе растет. Это приводит к увеличению температуры перехода и соседних с ним областей полупроводника, усиливаются колебания атомов кристалла, и ослабевает связь валентных электронов с ними. Возникает вероятность перехода электронов в зону проводимости и образования дополнительных пар электрон — дырка. При плохих условиях теплоотдачи от p-n перехода происходит лавинообразное нарастание температуры, что приводит к разрушению перехода.

На этом давайте закончим, а в следующей части рассмотрим устройство и работу выпрямительных диодов, диодного моста.
Удачи!

Источник:

1. Борисов В.Г — Юный радиолюбитель. 1985г.
2. Горюнов Н.Н. Носов Ю.Р — Полупроводниковые диоды. Параметры, методы измерений. 1968г.

Тест с ответами: “Переменный ток”

1. Переменный электрический ток относится к:
а) вынужденным электромагнитным колебаниям +
б) свободным электромагнитным колебаниям
в) затухающим электромагнитным колебаниям

2. Сила переменного тока практически во всех сечениях проводника одинакова потому, что:
а) сечение проводника везде одинаково
б) время распространения электромагнитного поля превышает период колебаний +
в) все электроны одинаковы по размерам

3. Сила тока на активном сопротивлении прямо пропорционально напряжению. Это выражение справедливо:
а) только для мгновенных значений силы тока и напряжения
б) только для амплитудных значений силы тока и напряжения
в) для мгновенных и амплитудных значений силы тока и напряжения +

4. Бытовые электроприборы рассчитаны на напряжение 220 В. Это такое значение переменного напряжения:
а) действующее +
б) амплитудное
в) среднее

5. Показания амперметров в цепи переменного и постоянного тока одинаковы. Это означает, что на одинаковых сопротивлениях в цепи переменного тока выделяется мощность:
а) большая, чем в цепи постоянного тока
б) меньшая, чем в цепи постоянного тока
в) такая же, как в цепи постоянного тока +

6. Какое явление лежит в основе действия генераторов:
а) электролиз
б) электромагнитная индукция +
в) намагничивание

7. Как называется подвижная часть генератора:
а) трансформатор
б) статор
в) ротор +

8. Проводник находится в электрическом поле. Как движутся в нем свободные электрические заряды:
а) упорядоченно +
б) хаотично
в) совершают колебательное движение

9. Что принято за направление электрического тока:
а) направление упорядоченного движения отрицательно заряженных частиц
б) определенного ответа дать нельзя
в) направление упорядоченного движения положительно заряженных частиц +

10. Как изменилась сила тока в цепи, если увеличилась концентрация заряженных частиц в 4 раза, а скорость электронов и сечение проводника остались прежними:
а) не изменилась
б) увеличилась в 4 раза +
в) уменьшилась в 4 раза

11. Реактивное сопротивление обозначается:
а) Х +
б) R
в) Z

12. Ёмкость определяется формулой:
а) Q= I 2 * Х
б) С =1/2f Хс +
в) L= Х L /2f

13. Полная мощность цепи определяется формулой:
а) S= U* I +
б) Q= I 2 * Х
в) Р = I 2 * R

14. Индуктивное сопротивление определяется формулой:
а) L= Х L /2f
б) Х L = 2f/ Х L
в) Х L = 2f L +

15. Выберите верное(-ые) утверждение(-я):
а) в электрических сетях нашей страны используется переменный ток +
б) в электрических сетях нашей страны используется постоянный ток
в) оба варианта верны

16. Где происходит промышленное получение, переменного тока:
а) на заводах
б) на электростанциях +
в) на фабриках

17. Какова роль источника тока в электрической цепи:
а) порождает заряженные частицы
б) создает и поддерживает разность потенциалов в электрической цепи
в) нет верного ответа +

18. Применение в осветительной сети напряжение переменного тока частотой в 10-15 Гц изменит характер работы устройств:
а) да
б) нет +
в) в редких случаях

19. Частота изменения переменного тока в промышленных цепях составляет:
а) 60 Гц
б) 70 Гц
в) 50 Гц +

20. Действующее значение силы переменного тока соответствует определенному значению силы постоянного тока, выделяющего такое же количество теплоты:
а) не соответствует
б) соответствует +
в) иногда

21. В цепи с емкостным сопротивлением колебания силы тока отстают от колебаний напряжения:
а) нет +
б) да
в) периодически

22. Переменный ток в цепи – это результат свободных электромагнитных колебаний:
а) да
б) нет +
в) периодически

23. Конденсатор создает бесконечное сопротивление постоянному току и определенное конечное значение для переменного тока:
а) не создает
б) время от времени
в) создает +

24. В цепи с индуктивным сопротивлением колебания напряжения отстают от колебаний силы тока:
а) не отстают
б) отстают +
в) периодически отстают

25. Возрастает ли индуктивное сопротивление с увеличением частоты колебаний:
а) сначала возрастает, потом падает
б) нет
в) да +

26. Действующее значение – это характеристика переменного тока:
а) нет
б) да +
в) в редких случаях

27. При совпадении частоты внешнего переменного напряжения с собственной частотой колебательного контура происходит резкое возрастание амплитуды колебаний силы тока:
а) происходит +
б) не происходит
в) когда как

28. Действующие значения силы тока и напряжения для данного переменного тока – постоянные величины:
а) периодически
б) нет
в) да +

29. В рамке, вращающейся в магнитном поле, индуцируется переменная ЭДС вследствие электромагнитной индукции:
а) индуцируется +
б) не индуцируется
в) периодически

30. Активное сопротивление поглощает энергию электромагнитного поля безвозвратно:
а) не поглощает
б) поглощает +
в) периодически

Режимы сварки: основные параметры и особенности

Во время любых строительных и промышленных работ часто применяется сварка. При помощи нее можно сваривать различные металлические конструкции, осуществлять ремонт оборудования и других изделий.

Существуют разные виды сварочных технологий, которые используются в зависимости от типа металла, его толщины, прочности и других важных параметров. Но также качество соединения зависит и от правильно выставленных настроек на сварочном оборудовании. Стоит предварительно рассмотреть основные режимы сварки, их особенности и правильную настройку.

Параметры сварки

Чтобы выполнить правильный выбор режима сварки стоит рассмотреть параметры сварочной технологии. Каждый сварщик должен знать, из каких веществ состоит металла, отличия состава, толщину и вид конструкции. После получения требуемой информации выставляют правильный режим. Имеется много критериев, от которых зависят качественные характеристики работ. По этой причине их разделяют на основные и дополнительные параметры режима сварки.

Основные

Основные параметры режима сварки оказывают влияние на объемы требуемой энергии, а также они определяют ее передачу на металлическую поверхность.

Среди главных показателей сварочной технологии можно выделить:

  • сила тока;
  • вид полярности тока;
  • род тока;
  • размер диаметра стержней;
  • показатель длины дуги;
  • уровень напряжения;
  • скорость движения вдоль соединения;
  • число проходов.

Каждый критерий параметр оказывает влияние на свойства формирования соединения. В процессе сваривания можно изменять показатели, это позволит получить более прочный и надежный шов.

Существуют определенные особенности основных параметров, которые необходимо учитывать при проведении сварочных работ:

  1. От показателя силы тока зависит интенсивность расплавления металла. Чем выше данный параметр, тем производительнее сварочный процесс. Если будет установлена высокая сила тока без учета требуемого диаметра электрода, тогда будет отмечаться снижение качественных характеристик шва. А при низком токе происходит обрывание дуги, и в результате этого появятся области с непроварами.
  2. Полярность тока является направлением движения энергии (от катода к аноду и наоборот). Совместно с направлением подбирают ток — он может быть постоянного или переменного типа. Если осуществляется сваривание с использованием постоянного тока с обратной полярностью, то соединение получится глубже на 40 %.
  3. При сваривании расплавляемый материал должен равномерно заполнять соединение. Иначе прочностные характеристики снизятся.

Дополнительные

Однако чтобы режим сварки был правильным, стоит выставить правильные настройки. Но они обычно устанавливаются с учетом дополнительных параметров, среди которых можно выделить:

  • вылет стержней;
  • вид материала и толщина покрытия электрода;
  • температурные показатели свариваемых изделий;
  • вид расположения элементов;
  • форма кромок;
  • степень подготовки поверхности.

Как подобрать сварочный ток

Расчет режимов ручной дуговой сварки осуществляется с учетом выставления главных параметров тока, а именно рода, полярности и силы. В зависимости от рода ток бывает переменным и постоянным. Полярность делится на прямую и обратную.

Рассматривая основные параметры режима сварки, стоит обратить внимание на величину силы тока. Она подбирается при помощи определенных таблиц. Показатель тока определяется в соответствии с толщиной свариваемых изделий из стали, сварочной проволоки. А вот точные показатели юстировки определяются в зависимости от вида дуги и соединения. Стоит учитывать, что чем сильнее ток, тем температурные показатели под основанием дуги будут выше. Это все отразится на скорости сварочных работ.

Проведение сварочной технологии с использованием тока с высокой силой и сильно тонкого сварочного провода может к перегреву и разбрызгиванию расплавленного металла. Если применяются слишком тонкие элементы, то данный режим может привести к их прожиганию.

При использовании тока со слабой силой может происходить обрывание дуги, она становится неустойчивой. В итоге соединение выходит низкого качества, образуется много зон с непроварами. По этой причине многие сварщики не советуют использовать данный режим.

Важно! Глубинные показатели сварочной ванны зависят от типа используемого тока. Если оборудование используется на переменном токе, то показатель глубины провара будет на 15 % выше, чем у переменного тока.

При прямой полярности отмечается сильное нагревание металлического изделия. По этой причине данную полярность рекомендуется применять для сваривания толстых элементов, потому что для образования качественного соединения требуется большее расплавление металла. Если прямая полярность будет применяться для тонких деталей, то они быстро сгорят и шов выйдет низкого качества. Для тонких изделий стоит применять ток с обратной полярностью.

Взаимосвязь между силой тока и толщиной электрода

Рассматривая параметры сварки, стоит обратить внимание на связь между силой тока и толщиной электрода. Размер стержня должен подбираться в соответствии с толщиной свариваемого шва и с используемым методом сварочной технологии. К примеру, для изделия с толщиной 3-4 мм рекомендуется применять стержни 3 мм. Сваривание многопрофильных элементов осуществляется в несколько проходов, на начальном этапе используется электрод с размером 4 мм.

После выбора стержней стоит воспользоваться специальными таблицами, в которых указывают требуемые показатели силы тока, именно они позволяют выполнить правильный расчет режимов сварки. К примеру, для стержней 3 мм соответствует показатель 65-100 А. Для вертикальной и потолочной сварки подходит электрод с диаметром не менее 4 мм. При горизонтальном сваривании сила тока снижается на 15-20 %.

Особенности длины дуги

На выбор и расчет режимов сварки оказывает влияние длина дуги, а именно расстояние от конца стержня до заготовки. Этот критерий зависит от выбранных стержней, обычно он указывается в специальных таблицах.

Стоит отметить! Чтобы получить прочное сварное соединение и качественное проваривание требуется добиться единого значения длины дуги по всей области шва. Для этого требуется опыт и определенные навыки.

Для стержней с диаметром 4 мм показатель длины дуги должен быть 4,5 мм. Сохранить данное состояние в течение сварочного процесса достаточно тяжело. Обычно для этих целей применяются сварочные каретки.

Диаметр электрода

Выбор параметров режима сварки осуществляется с учетом типа электрода. Диаметр зависит от показаний толщины металлического изделия и положения соединения. Независимо от толщины швы в разных положениях свариваются при помощи стержней с диаметром 4 мм.

Если шов обладает многослойной структурой, то для сваривания первого соединения стоит использовать стержни 3 или 4 мм. Остальные швы обрабатываются при помощи электродов с большим диаметром. Ниже имеется таблица режимов сварки, в которой указана толщина металла, диаметр электрода и сила тока.

Угол наклона электрода

Выполняя расчет режимов сварки полуавтоматом необходимо брать во внимание критерии угла наклона электрода. При сваривании стержень по отношению к шву должен быть с небольшим отклонением от нормы на 10 градусов. Глубина и ширина соединения зависит от расположения стержней к стыку.

Если сваривание осуществляется углом вперед, то глубинные показатели уменьшатся, а соединение расширится. Это происходит потому, что дуга нагоняет волну расплава перед собой, через которую выполняют расплавление металла.

Если выбирается режим с углом наклона назад, то расплав будет переходить в конец сварочной зоны. Электрическая дуга оказывает прямое влияние на соединяемые изделия. В результате этого будет увеличение глубины проплавления стыка и уменьшение ширины шва.

Наклон заготовок

Если вы думаете над тем, как рассчитать режим сварки, то не стоит упускать показатель наклона заготовок, которые используются для сваривания. В момент, когда держак проводят сверху вниз, то под дугой происходит утолщение расплава. В итоге глубина провара становится меньше, а соединение расширяется. Если сваривание начинается с нижней части с последующим движением вверх, то слой расплава под дугой истончается. Глубина ванны повышается, а соединение становится уже.

Важно! Если есть возможность при сварке производить наклон деталей, то их рекомендуется разместить так, чтобы область стыка располагалась под углом в 8-10 градусов.

Если соблюдать угол в пределах указанных параметрах, то будет формироваться нормальное соединение. При большем уклоне и при осуществлении сварки на спуск из кратера вытечет весь расплавленный металл. А при проведении сваривании сверху вниз будут возникать области с непроварами.

Скорость провара

Стоит учитывать, что расчет скорости сварки может влиять на прочностные качества соединения. При осуществлении сваривания расплавленная металлическая масса должна заполнять ванну. Должен выйти равномерный переход с образованием нормального покрытия кромок, а структура соединения должна быть без подрезов, наплывов.

Оптимальная длина шва должна быть в 1,5-2 раза больше диаметра применяемого стержня. Если будет превышена скорость сварки, то металлическая структура не сможет нормально прогреться, а прочность снизится.

Если изучить все важные параметры, то можно будет понять что такое режим сварки, и для чего он нужен. Правильные настройки и параметры позволяют выполнить качественное и прочное соединение, которое будет обладать высокой износостойкостью. Каждый показатель имеет огромное значение, особенно при изготовлении больших конструкций особого значения.

Интересное видео

ru: пользователи: документация: iw [Linux Wireless]

О iw

iw — это новая утилита конфигурирования интерфейса командной строки на основе nl80211 для беспроводных устройств. Он поддерживает все новые драйверы, которые были недавно добавлены в ядро. Старый инструмент iwconfig, использующий интерфейс Wireless Extensions, устарел, и настоятельно рекомендуется перейти на iw и nl80211.

Как и остальная часть ядра Linux, iw все еще находится в стадии разработки.Функции добавляются «по ходу». Единственная документация для iw — это эта страница и вывод из iw help. Пожалуйста, помогите расширить эту страницу.

На странице перечислены варианты использования iwconfig и iw: замена iwconfig.

Получение iw

Требования к сборке

  • библиотека> = libnl1

  • libnl-dev> = libnl-dev-1

  • pkg-config Использование iw требует наличия libnl, первая рабочая версия — 1.0 pre8, поскольку в этом выпуске представлен genl, Generic Netlink , на который опирается nl80211. Если libnl вашего дистрибутива — неправильная версия, вам придется пока загрузить и скомпилировать libnl самостоятельно (http://www.infradead.org/~tgr/libnl/).

Справка

Просто введите

 iw ​​справка 

в командной строке и распечатает поддерживаемые команды.

Получение возможностей устройства

Используйте следующее, чтобы получить возможности устройства для всех устройств, например информацию о диапазоне (2.4 ГГц и 5 ГГц ), а также информацию о 802.11n:

 iw ​​список 

Сканирование

Прослушивание событий

Просто используйте

 iw ​​событие 

При отладке может быть полезно увидеть фреймы auth / assoc / deauth / disassoc, используйте

 iw ​​событие -f 

а иногда также полезна информация о времени:

 iw ​​событие -t 

Получение статуса ссылки

Чтобы определить, подключены ли вы к AP или нет, и используете ли вы последнюю скорость передачи, вы можете использовать команду ниже.

Пример вывода при подключении к устаревшей (не 802.11n) точке доступа:

 iw ​​dev wlan0 ссылка
Подключено к 04: 21: b0: e8: c8: 8b (на wlan0)
        SSID: attwifi
        частота: 2437
        RX: 2272 байта (18 пакетов)
        TX: 232 байта (3 пакета)
        сигнал: -57 дБм
        tx битрейт: 36,0 Мбит / с 

Пример вывода при подключении к точке доступа 802.11n:

 iw ​​dev wlan0 ссылка
Подключено к 68: 7f: 74: 3b: b0: 01 (на wlan0)
        SSID: тесла-5g-bcm
        частота: 5745
        RX: 30206 байт (201 пакет)
        TX: 4084 байта (23 пакета)
        сигнал: -31 дБм
        tx битрейт: 300.0 Мбит / с MCS 15 40 МГц короткий GI 

Пример вывода без подключения к AP:

 iw ​​dev wlan0 ссылка
Не подключен. 

Это может произойти, если вы не подключены к AP. Для подключения к точке доступа можно использовать iw connect , если для подключения требуется:

  • Без шифрования

  • использует WEP для шифрования. Если вам необходимо подключиться к точке доступа с требованиями шифрования WPA или WPA2, вы должны использовать wpa_supplicant.

Установление базового подключения

Вы можете использовать iw для прямого подключения к AP, если и только если AP имеет:

  • Без шифрования

  • использует WEP для шифрования. Однако следует отметить, что если вы отключаетесь от точки доступа, что может происходить довольно часто в загруженной среде, вам нужно будет повторно ввести команду.Если вы не хотите этого делать, вы можете просто использовать wpa_supplicant, который автоматически попытается восстановить соединение при отключении.

Если вы решите самостоятельно решать проблемы с отключениями, вы можете использовать iw connect следующим образом.

Чтобы подключиться к AP с отключенным шифрованием, где SSID — foo :

 iw ​​wlan0 подключение foo 

Предположим, у вас есть две точки доступа с SSID foo , и вы знаете, что одна, к которой вы хотите подключиться, находится на частоте 2432, вы можете указать используемую частоту:

 iw ​​wlan0 подключение foo 2432 

Для подключения к точке доступа, использующей WEP, вы можете использовать:

 iw ​​wlan0 подключить клавиши foo 0: abcde d: 1: 0011223344 

Получение статистики станции

Чтобы получить статистическую информацию о станции, такую ​​как количество байтов tx / rx, последний битрейт TX (включая скорость MCS), вы можете сделать:

 $ iw dev wlan1 дамп станции
Станция 12:34: 56: 78: 9a: bc (на wlan0)
        время бездействия: 304 мс
        rx байтов: 18816
        rx пакетов: 75
        tx байт: 5386
        tx пакетов: 21
        сигнал: -29 дБм
        tx битрейт: 54.0 Мбит / с 

Получение статистики станции по отношению к партнеру

Если вы хотите получить конкретную статистику по узлу, с которым вы общаетесь, вы можете использовать следующее:

 sudo iw dev wlan1 station get  

В случае STA вышеупомянутый будет MAC-адресом вашей AP.

Изменение скорости передачи данных

iw поддерживает изменение битрейта TX, как устаревшего, так и HT MCS.Он делает это путем маскирования в разрешенных битрейтах, а также позволяет очистить маску.

Изменение устаревших битрейтов tx

Вы можете установить предпочтение для передачи с использованием только определенных устаревших битрейтов. Например:

 iw ​​wlan0 установить битрейты legacy-2.4 12 18 24 

Вот как включить то, что некоторые называют «Purge G», которая отключает ассоциации 802.11b:

 iw ​​wlan0 установить битрейты legacy-2.4 6 12 24 

Изменение битрейта tx HT MCS

Настройка предпочтения для передачи с использованием скоростей MCS поддерживается, позволяя указать диапазон и скорость MCS.Обратите внимание: будет ли устройство действительно слушать вашу петицию, будет зависеть от драйвера устройства и взаимодействия со стороны прошивки. Например:

 iw ​​dev wlan0 установить битрейты mcs-5 4 
 iw ​​dev wlan0 установить битрейты mcs-2.4 10 

Чтобы очистить все битрейты tx и вернуть все в норму:

 iw ​​dev wlan0 установить битрейты mcs-2.4
iw dev wlan0 установить битрейты mcs-5 

Настройка мощности передачи

Вы можете установить txpower, используя либо имя интерфейса устройства соответствующего файла phy.

 iw ​​dev  set txpower  []
iw phy <имя_файлы> set txpower  [] 

(Обратите внимание, что значение, которое принимает эта команда, составляет милли, бел-милливатт (мБм) вместо обычно используемого деци бел-милливатт (дБм). <Мощность в мБм> = 100 * <мощность в дБм>)

Экономия энергии

Чтобы включить энергосбережение по умолчанию, вы можете использовать:

 sudo iw dev wlan0 установить power_save на 

Для драйверов mac80211 это означает, что включена функция динамического энергосбережения.

Чтобы запросить текущие настройки энергосбережения, вы можете использовать:

 iw ​​dev wlan0 получить power_save 

Добавление интерфейсов с iw

Поддерживается несколько режимов. Поддерживаются следующие режимы:

  • монитор

  • управляемый [также станция]

  • wds

  • меш [также mp]

Например, чтобы добавить интерфейс монитора:

 iw ​​phy phy0 интерфейс добавить монитор типа moni0 

где вы можете заменить

 монитор 

чем-нибудь еще и

 moni0 

по имени интерфейса, и необходимо заменить

 phy0 

по имени PHY вашего оборудования (обычно phy0 будет правильным, если вы не подключили или не перезагрузили какие-либо модули.) Если ваш udev настроен неправильно, вновь созданный виртуальный интерфейс может быть сразу переименован им, используйте

 IP ссылка 

чтобы перечислить все интерфейсы. Чтобы создать новый интерфейс управляемого режима, вы должны использовать:

 iw ​​phy интерфейс phy0 добавить управляемый тип wlan10 

Обратите внимание, что интерфейс автоматически переводится в режим AP при использовании hostapd.

Изменение флагов интерфейса монитора

Вы можете настроить тип создаваемого интерфейса монитора.Это может быть очень полезно для целей отладки в системах конечных пользователей. Например, предположим, что вы хотите помочь пользователю. Вы можете воспользоваться тем фактом, что интерфейс монитора в mac80211 использует радиотапку для передачи дополнительных данных в пользовательское пространство. Скажем, мы хотим помочь пользователю выудить данные, не влияя на производительность устройства, установив для него полноценный интерфейс монитора. Интерфейс монитора без дополнительных флагов монитора можно создать следующим образом:

 iw ​​dev интерфейс wlan0 добавить флаги монитора типа fish0 нет 

Затем вы можете попросить пользователя использовать tcpdump в сеансе:

 tcpdump -i fish0 -s 65000 -p -U -w / tmp / fishing.дамп 

Хорошая вещь в этом типе альтернативных интерфейсов монитора заключается в том, что вы можете дополнительно расширить радиотап даже с расширениями поставщика, чтобы добавить больше данных в радиотапку, чтобы помочь отладить определенные функции устройства.

Имейте в виду, что для этого требуется, чтобы драйверы строго соблюдали запросы флагов mac80211, поэтому драйверы, такие как ath5k и ath9k, которые по-прежнему включают флаги в зависимости от режима работы, должны быть исправлены, чтобы воспользоваться этим.

Возможны флаги монитора

Вы можете указать следующие флаги:

  • нет

  • fcsfail

  • plcpfail

  • контроль

  • другие bss

  • повар

  • активный

Удаление интерфейсов с iw

Поддержка виртуального vif

Существует специальный раздел для поддержки виртуального vif, см. Страницу iw vif.

Обновление нормативного домена

Командная строка:

 iw ​​reg набор alpha2 

Где «альфа2» — это код страны альфа2 по ISO / IEC 3166. Используемая и установленная информация поступает из нашей нормативной инфраструктуры.

Вы также можете использовать последнюю версию wpa_supplicant (начиная с версии 0.6.7), чтобы изменить свой регулирующий домен, для этого просто добавьте, например, запись «country = US» в вашу конфигурацию.

Создание и проверка интерфейсов Mesh Point с помощью iw

Вы можете добавить интерфейс сетки к драйверам, поддерживающим работу точки сетки.Интерфейсы Mesh Point имеют параметр mesh_id длиной до 32 байтов. Например, чтобы добавить интерфейс «mesh0» к устройству phy0 с идентификатором mesh_id «mymesh»,

 iw ​​phy интерфейс phy0 добавить тип сетки mp mesh_id mymesh 

Интерфейсы Mesh Point по умолчанию настроены на Канале 1. Операция Mesh Point начинается, когда интерфейс активен. В конфигурации по умолчанию интерфейсы Mesh Point будут автоматически обнаруживать и пытаться создать одноранговые связи с другими точками Mesh Point (одноранговыми узлами), имеющими тот же идентификатор сети.Используйте список станций и статистику станций, чтобы просмотреть список одноранговых узлов и статус однорангового соединения.

После отправки трафика (например, pinging другого узла сети) вы можете захотеть увидеть список путей сетки:

 iw ​​dev mesh0 дамп mpath 

Пожалуйста, смотрите open80211s.org HOWTO для получения дополнительной информации о командах, связанных с Mesh Point, и их выводе, а также других примеров. iw также предоставляет команды для расширенной конфигурации Mesh Point. Они описаны в разделе Advanced Tinkering HOWTO open80211s.

Настройка узла WDS

Режим WDS является нестандартным расширением стандарта IEEE 802.11, позволяющим обеспечить прозрачный мост Ethernet на станции и реализовать передачу без стыковки для беспроводных клиентов, перемещающихся между различными точками доступа. Из-за своей нестандартной природы WDS часто по-разному реализуется в драйверах беспроводной сети и прошивках производителей, что делает их несовместимыми друг с другом. Чтобы использовать WDS, необходимо использовать одно и то же оборудование и программное обеспечение на всех развернутых беспроводных устройствах для обеспечения совместимости.

Чтобы создать одноранговый узел WDS, вам нужно сначала создать интерфейс типа WDS, а затем установить одноранговый узел:

 iw ​​phy интерфейс phy0 добавить wds0 типа wds
iw dev wds0 set peer  

Чтобы это работало, драйвер должен реализовать функцию обратного вызова cfg80211 set_wds_peer (). mac80211 реализует этот обратный вызов, поэтому соответствующий драйвер mac80211 просто должен поддерживать интерфейсы типа WDS. WDS заменит первый адрес в заголовке 802.11 адресом узла при передаче кадров.Вместо использования WDS вы можете рассмотреть возможность использования 4-адресного режима, описанного ниже, если у вас есть контроль над программным обеспечением, работающим на AP, и соответствующими подключенными клиентами / одноранговыми узлами.

Использование 4-адреса для режима точки доступа и клиента

В некоторых ситуациях может быть полезно запустить сеть с точкой доступа и несколькими клиентами, но с каждым клиентом, подключенным к сети за ним. Чтобы это работало, и клиент, и точка доступа должны передать кадры с 4 адресами, содержащие MAC-адреса источника и назначения.4-адресный режим — это то, как OpenWrt поддерживает режим WDS для драйверов mac80211, то есть, если вы включите опцию wds в своей беспроводной конфигурации OpenWrt OpenWrt, вы в конечном итоге будете использовать 4-адресный режим. 4-адресный режим несовместим с другими реализациями WDS, т. Е. Вам потребуются все конечные точки, использующие этот режим, чтобы WDS работала должным образом.

Беспроводная сеть Linux поддерживает 4-адресный режим для AP и STA, но каждый драйвер должен явно определять эту возможность. Все драйверы mac80211 поддерживают 4-адресный режим, если поддерживаются режимы работы AP или STA соответственно.

На стороне AP вы можете включить 4-адресные кадры для отдельных клиентов, изолировав их в отдельных AP VLAN, настроенных в 4-адресном режиме. Такая AP VLAN будет ограничена только одним клиентом, и этот клиент будет использоваться в качестве пункта назначения для всего трафика на его интерфейсе, независимо от MAC-адреса пункта назначения в заголовках пакетов. Преимущество этого режима по сравнению с обычным режимом WDS состоит в том, что его проще настроить и не требуется статический список одноранговых MAC-адресов на любой стороне.4-адресный режим несовместим с WDS.

Чтобы включить 4-адресный режим при создании интерфейса, вы должны добавить 4addr на , например:

 iw ​​phy phy0 interface add sta0 type managed 4addr на 

В этом режиме новый интерфейс может быть мостом — если это так, то вам нужно использовать

 -b 

флаг для wpa_supplicant, чтобы он слушал EAPOL на мосту, а не сам интерфейс.

В hostapd вы можете включить это с помощью флага hostapd.conf:

 wds_sta = 1 

Обратите внимание, что 4-адресный режим в настоящее время не работает в версии 3.9 из-за фиксации 576eb62598f10c8c7fd75703fe89010cdcfff596, эта тема в настоящее время рассматривается в списках рассылки для решения.

Создание правил объединения пакетов

В большинстве случаев хост, получающий многоадресные / широковещательные пакеты IPv4 и IPv6, ничего не делает с этими пакетами. Поэтому прием этих нежелательных пакетов вызывает ненужную обработку и потребление энергии.

Функция объединения пакетов помогает уменьшить количество прерываний приема на хост за счет буферизации этих пакетов во встроенном программном обеспечении / оборудовании в течение некоторого заранее определенного времени. Прерывание приема будет сгенерировано при возникновении одного из следующих событий.

  • Истечение срока действия аппаратного таймера, время истечения которого установлено на максимальную задержку объединения в соответствии с правилом объединения.

  • Коалесцирующий буфер на оборудовании достиг предела.

  • Пакет не соответствует ни одному из настроенных правил объединения.Чтобы просмотреть информацию о поддержке конфигурации coalesce, вы можете использовать «iw phy0 info». Вот пример вывода:

 Поддержка Coalesce:
         * Поддерживается максимум 8 правил объединения
         * Каждое правило содержит до 4 паттернов по 1-4 байта,
           максимальное смещение пакета 50 байт
         * Максимально поддерживаемая задержка объединения 100 мс 

Вам необходимо настроить следующие параметры для создания правила объединения.

  • Максимальная задержка слияния

  • Список шаблонов пакетов, которые необходимо сопоставить

  • Условие для коалесценции.шаблон «совпадение» или «нет совпадения». В файле конфигурации можно указать несколько таких правил.

Чтобы включить функцию объединения с использованием правил, перечисленных в файле coalesce.conf, вы можете использовать:

 iw ​​phy phy0 включить coalesce.conf 

Где coalesce.conf содержит:

 задержка = 25
условие = 0
шаблоны = 8 + 34: xx: ad: 22,10 + 23: 45: 67,59: 33: xx: 25, ff: ff: ff: ff
задержка = 40
условие = 1
шаблоны = 12 + 00: xx: 12,23: 45: 67,46: 61: xx: 50 

Чтобы отобразить текущую конфигурацию объединения, вы можете использовать:

 $ iw phy phy0 coalesce шоу
Coalesce включен:
Правило - максимальная задержка объединения: 25 мс условие: совпадение
 * смещение пакета: 8 шаблон: 34: -: ad: 22
 * смещение пакета: 10 шаблон: 23:45:67
 * смещение пакета: 0 шаблон: 59:33: -: 25
 * смещение пакета: 0 шаблон: ff: ff: ff: ff
Правило - максимальная задержка объединения: 40 мсек. Условие: не совпадает.
 * смещение пакета: 12 шаблон: 00: -: 12
 * смещение пакета: 0 шаблон: 23:45:67
 * смещение пакета: 0 шаблон: 46:61: -: 50 

Чтобы отключить функцию объединения, вы можете использовать:

 iw ​​phy phy0 coalesce отключить 

Вывод iw display, когда coalesce не настроен:

 $ iw phy phy0 coalesce шоу
Coalesce отключен.

% PDF-1.6 % 15132 0 объект > endobj xref 15132 457 0000000016 00000 н. 0000012182 00000 п. 0000012703 00000 п. 0000012742 00000 п. 0000013203 00000 п. 0000013733 00000 п. 0000014193 00000 п. 0000014720 00000 п. 0000014792 00000 п. 0000014897 00000 п. 0000015171 00000 п. 0000015432 00000 п. 0000015541 00000 п. 0000015819 00000 п. 0000017023 00000 п. 0000018054 00000 п. 0000019097 00000 п. 0000020113 00000 п. 0000020186 00000 п. 0000021355 00000 п. 0000022583 00000 п. 0000023135 00000 п. 0000023208 00000 п. 0000023476 00000 п. 0000024750 00000 п. 0000025786 00000 п. 0000037742 00000 п. 0000055282 00000 п. 0000077212 00000 п. 00000 00000 п. 00000 00000 п. 00000

00000 п. 0000095763 00000 п. 0000096220 00000 п. 0000096309 00000 п. 0000113189 00000 н. 0000113232 00000 н. 0000113668 00000 н. 0000113742 00000 н. 0000123599 00000 н. 0000123642 00000 н. 0000123706 00000 н. 0000123846 00000 н. 0000123972 00000 н. 0000124061 00000 н. 0000124143 00000 н. 0000124248 00000 н. 0000124421 00000 н. 0000124564 00000 н. 0000124696 00000 н. 0000124856 00000 н. 0000125016 00000 н. 0000125131 00000 н. 0000125286 00000 н. 0000125376 00000 н. 0000125542 00000 н. 0000125692 00000 н. 0000125820 00000 н. 0000125915 00000 н. 0000126072 00000 н. 0000126208 00000 н. 0000126350 00000 н. 0000126515 00000 н. 0000126650 00000 н. 0000126792 00000 н. 0000126948 00000 н. 0000127083 00000 н. 0000127225 00000 н. 0000127395 00000 н. 0000127485 00000 н. 0000127640 00000 н. 0000127799 00000 н. 0000127888 00000 н. 0000127991 00000 н. 0000128156 00000 н. 0000128245 00000 н. 0000128403 00000 н. 0000128569 00000 н. 0000128658 00000 н. 0000128807 00000 н. 0000128970 00000 н. 0000129059 00000 н. 0000129209 00000 н. 0000129370 00000 н. 0000129459 00000 н. 0000129548 00000 н. 0000129699 00000 н. 0000129828 00000 н. 0000129938 00000 н. 0000130079 00000 н. 0000130177 00000 н. 0000130280 00000 н. 0000130382 00000 п. 0000130493 00000 п. 0000130619 00000 п. 0000130734 00000 п. 0000130839 00000 п. 0000130936 00000 н. 0000131065 00000 н. 0000131193 00000 н. 0000131318 00000 н. 0000131434 00000 н. 0000131556 00000 н. 0000131719 00000 н. 0000131810 00000 н. 0000131910 00000 н. 0000132063 00000 н. 0000132189 00000 н. 0000132299 00000 н. 0000132462 00000 н. 0000132582 00000 н. 0000132681 00000 н. 0000132805 00000 н. 0000132958 00000 н. 0000133064 00000 н. 0000133175 00000 н. 0000133279 00000 н. 0000133385 00000 н. 0000133552 00000 н. 0000133683 00000 н. 0000133807 00000 н. 0000133975 00000 н. 0000134096 00000 н. 0000134233 00000 п. 0000134365 00000 н. 0000134531 00000 н. 0000134692 00000 н. 0000134812 00000 н. 0000134949 00000 н. 0000135086 00000 н. 0000135182 00000 п. 0000135321 00000 н. 0000135476 00000 н. 0000135592 00000 н. 0000135731 00000 н. 0000135890 00000 н. 0000136010 00000 н. 0000136115 00000 н. 0000136251 00000 н. 0000136372 00000 н. 0000136513 00000 н. 0000136690 00000 н. 0000136814 00000 н. 0000136941 00000 н. 0000137115 00000 н. 0000137238 00000 н. 0000137346 00000 н. 0000137476 00000 н. 0000137600 00000 н. 0000137748 00000 н. 0000137845 00000 н. 0000137947 00000 н. 0000138064 00000 н. 0000138183 00000 п. 0000138280 00000 н. 0000138382 00000 п. 0000138499 00000 н. 0000138618 00000 н. 0000138737 00000 н. 0000138877 00000 н. 0000139033 00000 н. 0000139150 00000 н. 0000139272 00000 н. 0000139463 00000 п. 0000139636 00000 н. 0000139746 00000 н. 0000139848 00000 н. 0000139983 00000 н. 0000140157 00000 н. 0000140270 00000 н. 0000140379 00000 н. 0000140487 00000 н. 0000140597 00000 н. 0000140750 00000 н. 0000140894 00000 н. 0000141021 00000 н. 0000141189 00000 н. 0000141306 00000 н. 0000141421 00000 н. 0000141574 00000 н. 0000141716 00000 н. 0000141895 00000 н. 0000141999 00000 н. 0000142133 00000 п. 0000142256 00000 н. 0000142376 00000 н. 0000142509 00000 н. 0000142625 00000 н. 0000142731 00000 н. 0000142834 00000 п. 0000142963 00000 н. 0000143111 00000 п. 0000143260 00000 н. 0000143414 00000 н. 0000143527 00000 н. 0000143643 00000 п. 0000143800 00000 н. 0000143906 00000 н. 0000144026 00000 н. 0000144183 00000 п. 0000144282 00000 н. 0000144398 00000 н. 0000144523 00000 н. 0000144679 00000 н. 0000144769 00000 н. 0000144926 00000 н. 0000145016 00000 н. 0000145151 00000 п. 0000145285 00000 н. 0000145430 00000 н. 0000145563 00000 н. 0000145702 00000 н. 0000145825 00000 н. 0000145989 00000 н. 0000146092 00000 н. 0000146193 00000 п. 0000146324 00000 н. 0000146438 00000 н. 0000146563 00000 н. 0000146657 00000 н. 0000146749 00000 н. 0000146859 00000 н. 0000146942 00000 н. 0000147038 00000 н. 0000147139 00000 н. 0000147260 00000 н. 0000147345 00000 н. 0000147453 00000 н. 0000147554 00000 н. 0000147680 00000 н. 0000147805 00000 н. 0000147930 00000 н. 0000148015 00000 н. 0000148177 00000 н. 0000148277 00000 н. 0000148414 00000 н. 0000148563 00000 н. 0000148697 00000 н. 0000148850 00000 н. 0000148942 00000 н. 0000149028 00000 н. 0000149194 00000 п. 0000149286 00000 п. 0000149385 00000 н. 0000149511 00000 н. 0000149672 00000 н. 0000149759 00000 н. 0000149857 00000 н. 0000150018 00000 н. 0000150090 00000 н. 0000150252 00000 н. 0000150345 00000 н. 0000150429 00000 н. 0000150592 00000 н. 0000150680 00000 н. 0000150769 00000 н. 0000150939 00000 н. 0000151020 00000 н. 0000151185 00000 н. 0000151262 00000 н. 0000151428 00000 н. 0000151506 00000 н. 0000151668 00000 н. 0000151742 00000 н. 0000151909 00000 н. 0000151988 00000 н. 0000152111 00000 н. 0000152278 00000 н. 0000152370 00000 н. 0000152459 00000 н. 0000152622 00000 н. 0000152711 00000 н. 0000152801 00000 н. 0000152962 00000 н. 0000153039 00000 н. 0000153196 00000 н. 0000153284 00000 н. 0000153376 00000 н. 0000153496 00000 н. 0000153599 00000 н. 0000153676 00000 н. 0000153779 00000 н. 0000153877 00000 н. 0000153989 00000 н. 0000154134 00000 н. 0000154238 00000 н. 0000154337 00000 н. 0000154433 00000 н. 0000154534 00000 н. 0000154640 00000 н. 0000154794 00000 н. 0000154957 00000 н. 0000155125 00000 н. 0000155277 00000 н. 0000155418 00000 н. 0000155522 00000 н. 0000155680 00000 н. 0000155795 00000 н. 0000155907 00000 н. 0000156038 00000 н. 0000156197 00000 н. 0000156314 00000 н. 0000156432 00000 н. 0000156555 00000 н. 0000156681 00000 н. 0000156789 00000 н. 0000156905 00000 н. 0000157023 00000 н. 0000157113 00000 н. 0000157205 00000 н. 0000157299 00000 н. 0000157396 00000 н. 0000157574 00000 н. 0000157668 00000 н. 0000157765 00000 н. 0000157943 00000 н. 0000158037 00000 н. 0000158134 00000 н. 0000158313 00000 н. 0000158407 00000 н. 0000158504 00000 н. 0000158684 00000 н. 0000158778 00000 н. 0000158875 00000 н. 0000159050 00000 н. 0000159144 00000 н. 0000159241 00000 н. 0000159419 00000 н. 0000159513 00000 н. 0000159610 00000 н. 0000159790 00000 н. 0000159884 00000 н. 0000159981 00000 н. 0000160151 00000 п. 0000160245 00000 н. 0000160342 00000 п. 0000160436 00000 н. 0000160533 00000 н. 0000160689 00000 н. 0000160783 00000 н. 0000160890 00000 н. 0000161007 00000 н. 0000161146 00000 н. 0000161293 00000 н. 0000161405 00000 н. 0000161518 00000 н. 0000161656 00000 н. 0000161787 00000 н. 0000161921 00000 н. 0000162056 00000 н. 0000162171 00000 н. 0000162295 00000 н. 0000162428 00000 н. 0000162558 00000 н. 0000162687 00000 н. 0000162815 00000 н. 0000162943 00000 н. 0000163076 00000 н. 0000163206 00000 н. 0000163335 00000 н. 0000163463 00000 н. 0000163591 00000 н. 0000163724 00000 н. 0000163854 00000 н. 0000163983 00000 н. 0000164111 00000 п. 0000164239 00000 н. 0000164372 00000 н. 0000164502 00000 н. 0000164631 00000 н. 0000164759 00000 н. 0000164887 00000 н. 0000165020 00000 н. 0000165151 00000 н. 0000165280 00000 н. 0000165408 00000 н. 0000165536 00000 н. 0000165669 00000 н. 0000165799 00000 н. 0000165928 00000 н. 0000166056 00000 н. 0000166183 00000 н. 0000166315 00000 н. 0000166444 00000 н. 0000166572 00000 н. 0000166699 00000 н. 0000166826 00000 н. 0000166958 00000 н. 0000167087 00000 н. 0000167215 00000 н. 0000167342 00000 н. 0000167469 00000 н. 0000167602 00000 н. 0000167731 00000 н. 0000167859 00000 н. 0000167986 00000 н. 0000168113 00000 п. 0000168245 00000 н. 0000168375 00000 н. 0000168503 00000 н. 0000168630 00000 н. 0000168757 00000 н. 0000168889 00000 н. 0000169018 00000 н. 0000169146 00000 н. 0000169273 00000 н. 0000169400 00000 н. 0000169533 00000 н. 0000169662 00000 н. 0000169791 00000 н. 0000169918 00000 н. 0000170040 00000 н. 0000170172 00000 н. 0000170302 00000 п. 0000170430 00000 н. 0000170557 00000 н. 0000170680 00000 н. 0000170812 00000 н. 0000170941 00000 п. 0000171069 00000 н. 0000171197 00000 н. 0000171319 00000 н. 0000171451 00000 н. 0000171580 00000 н. 0000171708 00000 н. 0000171814 00000 н. 0000171968 00000 н. 0000172095 00000 н. 0000172221 00000 н. 0000172396 00000 н. 0000172525 00000 н. 0000172659 00000 н. 0000172804 00000 н. 0000172915 00000 н. 0000173029 00000 н. 0000173160 00000 н. 0000173285 00000 н. 0000173382 00000 н. 0000173479 00000 н. 0000173576 00000 н. 0000173673 00000 н. 0000173770 00000 н. 0000173867 00000 н. 0000173964 00000 н. 0000174061 00000 н. 0000174158 00000 н. 0000174255 00000 н. 0000174352 00000 н. 0000174449 00000 н. 0000174546 00000 н. 0000174643 00000 н. 0000174740 00000 н. 0000174837 00000 н. 0000174934 00000 н. 0000175031 00000 н. 0000175128 00000 н. 0000009436 00000 н. трейлер ] / Назад 3179018 >> startxref 0 %% EOF 15588 0 объект > поток hZl wgybBNhy @ \! mY… ҥme1Ö RXl3JU2 [1iUV: Ҿ9w6MIl

Telegram Bot API

Bot API — это интерфейс на основе HTTP, созданный для разработчиков, заинтересованных в создании ботов для Telegram.
Чтобы узнать, как создать и настроить бота, обратитесь к разделу Introduction to Bots and Bot FAQ .

Последние изменения

Подпишитесь на @BotNews, чтобы первым узнавать о последних обновлениях и присоединяться к обсуждению в @BotTalk

4 ноября 2020

Представляем Bot API 5.0

Запуск собственного сервера API ботов

  • Исходный код Bot API теперь доступен по адресу telegram-bot-api.Теперь вы можете запустить свой собственный сервер Bot API локально, повысив производительность ваших ботов (проверьте это, чтобы узнать, пойдет ли это на пользу вашему проекту).
  • Добавлен метод logOut, который можно использовать для выхода из облачного сервера API бота перед локальным запуском бота. Вы должны выйти из бота перед его локальным запуском, в противном случае нет гарантии, что бот получит все обновления.
  • Добавлен метод close, который можно использовать для закрытия экземпляра бота перед перемещением его с одного локального сервера на другой.

Передача права собственности на бот

  • Теперь вы можете использовать @BotFather для переноса существующих ботов в другую учетную запись Telegram.

Вебхуки

  • В метод setWebhook добавлен параметр ip_address , позволяющий обойти преобразование DNS и использовать указанный фиксированный IP-адрес для отправки запросов веб-перехватчиков.
  • В класс WebhookInfo добавлено поле ip_address , содержащее текущий IP-адрес, используемый для создания соединений веб-перехватчиков.
  • Добавлена ​​возможность отбрасывать все ожидающие обновления при изменении URL-адреса веб-перехватчика с помощью параметра drop_pending_updates в методах setWebhook и deleteWebhook.

Работа с группами

  • Запрос getChat теперь возвращает биографию пользователя для приватных чатов, если она доступна.
  • Запрос getChat теперь возвращает идентификатор связанного чата для супергрупп и каналов, то есть идентификатор группы обсуждения для канала и наоборот.
  • Запрос getChat теперь возвращает местоположение, к которому подключена супергруппа (см. Локальные группы). Добавлен класс ChatLocation для представления местоположения.
  • Добавлен параметр only_if_banned к методу unbanChatMember, чтобы разрешить безопасную разблокировку.

Работа с файлами

  • В классы Аудио и Видео добавлено поле file_name , содержащее имя исходного файла.
  • Добавлена ​​возможность отключить определение типа содержимого файла на стороне сервера с помощью параметра disable_content_type_detection в методе sendDocument и классе inputMediaDocument.

Множественные закрепленные сообщения

  • Добавлена ​​возможность закреплять сообщения в приватных чатах .
  • Добавлен параметр message_id к методу unpinChatMessage, чтобы разрешить открепление конкретного закрепленного сообщения.
  • Добавлен метод unpinAllChatMessages, который можно использовать для открепления всех закрепленных сообщений в чате.

Файловые альбомы

  • Добавлена ​​поддержка отправки и получения альбомов аудио и документов в методе sendMediaGroup.

Текущие места

Анонимные администраторы

  • В класс Message добавлено поле sender_chat , содержащее отправителя сообщения, которое является чатом (группой или каналом). Для обратной совместимости в неканальных чатах поле из в таких сообщениях будет содержать пользователя 777000 для сообщений, автоматически перенаправляемых в группу обсуждения, и пользователя 1087968824 (@GroupAnonymousBot) для сообщений от анонимных администраторов группы.
  • В класс chatMember добавлено поле is_anonymous , которое можно использовать для распознавания администраторов анонимного чата.
  • Добавлен параметр is_anonymous в метод promoChatMember, позволяющий продвигать анонимных администраторов чата. Сам бот должен иметь на это право is_anonymous . Несмотря на то, что боты могут иметь право is_anonymous , они никогда не будут отображаться как анонимные в чате. Боты могут использовать право только для передачи другим администраторам.
  • Добавлен настраиваемый заголовок отправителя анонимного сообщения в класс Message как author_signature .

и более

  • Добавлен метод copyMessage, который отправляет копию любого сообщения.
  • Максимальная длина вопроса опроса увеличена до 300.
  • Добавлена ​​возможность вручную указать текстовые объекты вместо указания parse_mode в классах InputMediaPhoto, InputMediaVideo, InputMediaAnimation, InputMediaAudio, InputMediaDocument, InlineQueryResultPhoto, InlineQueryResultGif, InlineQueryResultMpeg4Gif, InlineQueryResultVideo, InlineQueryResultAudio, InlineQueryResultVoice, InlineQueryResultDocument, InlineQueryResultCachedPhoto, InlineQueryResultCachedGif, InlineQueryResultCachedMpeg4Gif, InlineQueryResultCachedVideo , InlineQueryResultCachedAudio, InlineQueryResultCachedVoice, InlineQueryResultCachedDocument, InputTextMessageContent и методы sendMessage, sendPhoto, sendVideo, sendAnimation, sendAudio, sendDocument, sendVoice, sendPollage, editMessageTessage.
  • Добавлены поля google_place_id и google_place_type в классы Venue, InlineQueryResultVenue, InputVenueMessageContent и дополнительные параметры google_place_id и google_place_type в метод sendVenue для поддержки Google Places в качестве поставщика API места проведения.
  • Добавлено поле allow_sending_without_reply в методы sendMessage, sendPhoto, sendVideo, sendAnimation, sendAudio, sendDocument, sendSticker, sendVideoNote, sendVoice, sendLocation, sendVenue, sendContact, sendPoll, sendDice, sendInvoice, send AllowGames в качестве сообщений a, sendInvoice, sendlowGroup в качестве сообщений ответить, если ответное сообщение уже было удалено.

И последнее, но самое меньшее

  • Поддерживается новый футбол и игровой автомат анимации для случайных игральных костей. Выберите между различными анимациями (игра в кости, дартс, баскетбол, футбол, игровой автомат), указав параметр emoji в методе sendDice.
4 июня 2020 г.

Бот API 4.9

  • Добавлено новое поле via_bot в объект сообщения.Теперь вы можете узнать, какой бот использовался для отправки сообщения.
  • Поддерживаются эскизы видео для встроенной анимации GIF и MPEG4.
  • Поддерживается новая анимация баскетбола для случайных игральных костей. Выберите между различными анимациями (игра в кости, дартс, баскетбол), указав параметр emoji в методе sendDice.
24 апреля 2020

Бот API 4.8

  • Поддерживаемые объяснения викторин 2.0. Добавьте пояснения, указав параметры объяснение и объяснение_parse_mode в методе sendPoll.
  • Добавлены поля объяснение, и объяснение_entities к объекту опроса.
  • Поддерживаются опросы по времени, которые автоматически закрываются в определенную дату и время. Настройте, указав параметр open_period или close_date в методе sendPoll.
  • Добавлены поля open_period и close_date в объект Poll.
  • Поддерживается новая анимация дартса для мини-игры в кости. Выберите между анимацией игральных костей по умолчанию и анимацией дартса, указав параметр emoji в методе sendDice.
  • К объекту Dice добавлено поле emoji .
30 марта 2020 г.

Бот API 4.7

  • Добавлен метод sendDice для отправки сообщения о кубиках, которое будет иметь случайное значение от 1 до 6. (Да, мы знаем о «правильном» единственном числе die . Но это неудобно, и мы решили чтобы помочь ему измениться. По одной кости за раз!)
  • Добавлен кубик поля в объект сообщения.
  • Добавлен метод getMyCommands для получения текущего списка команд бота.
  • Добавлен метод setMyCommands для изменения списка команд бота через Bot API вместо @BotFather.
  • Добавлена ​​возможность создавать наборы анимированных стикеров путем указания параметра tgs_sticker вместо png_sticker в методе createNewStickerSet.
  • Добавлена ​​возможность добавлять анимированные стикеры в наборы, созданные ботом, указав параметр tgs_sticker вместо png_sticker в методе addStickerToSet.
  • Добавлено поле thumb в объект StickerSet.
  • Добавлена ​​возможность изменять эскизы наборов стикеров, созданных ботом с помощью метода setStickerSetThumb.

См. Более ранние изменения »

Авторизация бота

При создании каждому боту выдается уникальный токен аутентификации. Маркер выглядит примерно так: 123456: ABC-DEF1234ghIkl-zyx57W2v1u123ew11 , но вместо этого в этом документе мы будем использовать просто .Вы можете узнать о получении токенов и создании новых в этом документе.

Запросы

Все запросы к Telegram Bot API должны обслуживаться через HTTPS и должны быть представлены в следующей форме: https://api.telegram.org/bot/METHOD_NAME . Как это например:

  https://api.telegram.org/bot123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11/getMe  

Мы поддерживаем методы HTTP GET и POST .Мы поддерживаем четыре способа передачи параметров в запросах Bot API:

  • Строка запроса URL
  • приложение / x-www-form-urlencoded
  • application / json (кроме загрузки файлов)
  • multipart / form-data (используется для загрузки файлов)

Ответ содержит объект JSON, который всегда имеет логическое поле «ok» и может иметь необязательное поле String «description» с понятным для человека описанием результата. Если «ok» равно true, запрос был успешным, и результат запроса можно найти в поле «результат».В случае неудачного запроса «ok» равно false, а ошибка объясняется в «описании». Также возвращается целочисленное поле error_code, но его содержимое может измениться в будущем. Некоторые ошибки также могут иметь необязательное поле «параметры» типа ResponseParameters, которое может помочь автоматически обработать ошибку.

  • Все методы в Bot API нечувствительны к регистру.
  • Все запросы должны выполняться с использованием UTF-8.
Создание запросов при получении обновлений

Если вы используете веб-перехватчик , вы можете выполнить запрос к API бота при отправке ответа на веб-перехватчик.Используйте тип содержимого ответа application / json или application / x-www-form-urlencoded или multipart / form-data для передачи параметров. Укажите метод, который должен быть вызван, в параметре method запроса. Невозможно узнать, что такой запрос был успешным, или получить его результат.

Примеры см. В нашем FAQ.

Использование локального сервера API ботов

Исходный код сервера Bot API доступен по адресу telegram-bot-api.Вы можете запустить его локально и отправлять запросы на свой сервер вместо https://api.telegram.org . Если вы переключитесь на локальный сервер API ботов, ваш бот сможет:

  • Скачивание файлов без ограничения размера.
  • Загружайте файлы размером до 2000 МБ.
  • Загрузите файлы, используя их локальный путь и схему URI файла.
  • Используйте URL-адрес HTTP для веб-перехватчика.
  • Используйте любой локальный IP-адрес для веб-перехватчика.
  • Используйте любой порт для веб-перехватчика.
  • Установить max_webhook_connections от до 100000.
  • Получить абсолютный локальный путь как значение поля file_path без необходимости загружать файл после запроса getFile.
Нужен ли мне локальный сервер API ботов?

Большинство ботов будут в порядке с конфигурацией по умолчанию, работающей на наших серверах. Но если вы чувствуете, что вам нужна одна из этих функций, вы можете переключиться на свою в любое время.

Получение обновлений

Существует два взаимоисключающих способа получения обновлений для вашего бота — метод getUpdates с одной стороны и Webhooks с другой.Входящие обновления хранятся на сервере до тех пор, пока бот не получит их в любом случае, но они не будут храниться дольше 24 часов.

Независимо от того, какой вариант вы выберете, в результате вы получите JSON-сериализованные объекты обновления.

Обновление

Этот объект представляет входящее обновление.
Максимум один дополнительных параметров может присутствовать в любом данном обновлении.

Поле Тип Описание
update_id Целое число Уникальный идентификатор обновления.Идентификаторы обновления начинаются с определенного положительного числа и последовательно увеличиваются. Этот идентификатор становится особенно удобным, если вы используете Webhooks, поскольку он позволяет игнорировать повторяющиеся обновления или восстанавливать правильную последовательность обновлений, если они выходят из строя. Если новых обновлений нет хотя бы неделю, то идентификатор следующего обновления будет выбран случайно, а не последовательно.
сообщение Сообщение Необязательно . Новое входящее сообщение любого типа — текст, фото, стикер и т. Д.
edited_message Сообщение Необязательно . Новая версия сообщения, известная боту и отредактированная
канал_пост Сообщение Необязательно . Новые входящие сообщения на канале любого типа — текст, фото, стикеры и т. Д.
edited_channel_post Сообщение Необязательно . Новая версия известного боту поста на канале отредактирована
inline_query InlineQuery Необязательно .Новый входящий встроенный запрос
selected_inline_result ChosenInlineResult Необязательно . Результат встроенного запроса, который был выбран пользователем и отправлен своему партнеру по чату. Пожалуйста, ознакомьтесь с нашей документацией по сбору отзывов, чтобы узнать, как включить эти обновления для вашего бота.
callback_query CallbackQuery Необязательно . Новый входящий запрос обратного вызова
shipping_query Запрос на доставку Необязательно .Новый входящий запрос на доставку. Только для счетов с гибкой ценой
pre_checkout_query PreCheckoutQuery Необязательно . Новый входящий предварительный запрос. Содержит полную информацию о кассе
опрос Опрос Необязательно . Новое состояние опроса. Боты получают только обновления об остановленных опросах и опросах, которые отправляет бот
poll_answer Ответ на опрос Необязательно .Пользователь изменил свой ответ в неанонимном опросе. Боты получают новые голоса только в опросах, которые отправил сам бот.
getUpdates

Используйте этот метод для получения входящих обновлений с помощью длительного опроса (вики). Возвращается массив объектов обновления.

Параметр Тип Требуется Описание
смещение Целое число Дополнительно Идентификатор первого возвращаемого обновления.Должен быть на единицу больше, чем самый высокий среди идентификаторов ранее полученных обновлений. По умолчанию возвращаются обновления, начиная с самого раннего неподтвержденного обновления. Обновление считается подтвержденным, как только вызывается getUpdates со смещением на выше, чем его update_id . Отрицательное смещение может быть указано для получения обновлений, начиная с -offset update от конца очереди обновлений. Все предыдущие обновления будут забыты.
предел Целое число Дополнительно Ограничивает количество получаемых обновлений.Принимаются значения от 1 до 100. По умолчанию 100.
тайм-аут Целое число Дополнительно Тайм-аут в секундах для длительного опроса. По умолчанию 0, т.е. обычный короткий опрос. Должен быть положительным, короткий опрос следует использовать только в целях тестирования.
allowed_updates Массив строк Дополнительно Сериализованный в формате JSON список типов обновлений, которые должен получать бот. Например, укажите [«сообщение», «edited_channel_post», «callback_query»], чтобы получать обновления только этих типов.См. Обновление для получения полного списка доступных типов обновлений. Укажите пустой список для получения всех обновлений независимо от типа (по умолчанию). Если не указан, будет использоваться предыдущая настройка.

Обратите внимание, что этот параметр не влияет на обновления, созданные до вызова getUpdates, поэтому нежелательные обновления могут быть получены в течение короткого периода времени.

Примечания
1. Этот метод не будет работать, если настроен исходящий веб-перехватчик.
2. Чтобы избежать дублирования обновлений, пересчитывайте смещения после каждого ответа сервера.

набор Webhook

Используйте этот метод, чтобы указать URL-адрес и получать входящие обновления через исходящий веб-перехватчик. При каждом обновлении для бота мы будем отправлять HTTPS-запрос POST на указанный URL-адрес, содержащий сериализованное обновление JSON. В случае неудачного запроса мы откажемся от него после разумного количества попыток. В случае успеха возвращает True .

Если вы хотите убедиться, что запрос Webhook исходит от Telegram, мы рекомендуем использовать секретный путь в URL-адресе, например https://www.example.com/ <токен> . Поскольку никто другой не знает токен вашего бота, можете быть уверены, что это мы.

Параметр Тип Требуется Описание
url Строка Есть URL-адрес HTTPS для отправки обновлений.Используйте пустую строку для удаления интеграции веб-перехватчика
сертификат Входной файл Дополнительно Загрузите свой сертификат открытого ключа, чтобы можно было проверить используемый корневой сертификат. См. Подробности в нашем самоподписанном руководстве.
ip_адрес Строка Дополнительно Фиксированный IP-адрес, который будет использоваться для отправки запросов веб-перехватчика вместо IP-адреса, разрешенного через DNS
max_connections Целое число Дополнительно Максимально допустимое количество одновременных HTTPS-подключений к веб-перехватчику для доставки обновлений, 1–100.По умолчанию 40 . Используйте более низкие значения, чтобы ограничить нагрузку на сервер вашего бота, и более высокие значения, чтобы увеличить пропускную способность вашего бота.
allowed_updates Массив строк Дополнительно Сериализованный в формате JSON список типов обновлений, которые должен получать бот. Например, укажите [«сообщение», «edited_channel_post», «callback_query»], чтобы получать обновления только этих типов. См. Обновление для получения полного списка доступных типов обновлений. Укажите пустой список для получения всех обновлений независимо от типа (по умолчанию).Если не указан, будет использоваться предыдущая настройка.
Обратите внимание, что этот параметр не влияет на обновления, созданные до вызова setWebhook, поэтому нежелательные обновления могут быть получены в течение короткого периода времени.
drop_pending_updates логический Дополнительно Pass True для удаления всех ожидающих обновлений

Примечания
1. Вы не сможете получать обновления с помощью getUpdates, пока настроен исходящий веб-перехватчик.
2. Чтобы использовать самозаверяющий сертификат, вам необходимо загрузить сертификат открытого ключа с помощью параметра certificate . Пожалуйста, загрузите как InputFile, отправка строки не будет работать.
3. В настоящее время поддерживаются порты для Webhooks : 443, 80, 88, 8443 .

НОВИНКА! Если у вас возникли проблемы с настройкой веб-перехватчиков, ознакомьтесь с этим замечательным руководством по веб-перехватчикам.

удалитьWebhook

Используйте этот метод для удаления интеграции с веб-перехватчиком, если вы решите вернуться к getUpdates.В случае успеха возвращает True .

Параметр Тип Требуется Описание
drop_pending_updates логический Дополнительно Pass True для удаления всех ожидающих обновлений
getWebhookInfo

Используйте этот метод, чтобы получить текущий статус веб-перехватчика. Не требует параметров. В случае успеха возвращает объект WebhookInfo.Если бот использует getUpdates, он вернет объект с пустым полем url ​​.

WebhookInfo

Содержит информацию о текущем состоянии веб-перехватчика.

Поле Тип Описание
url Строка URL-адрес веб-перехватчика, может быть пустым, если веб-перехватчик не настроен
has_custom_certificate логический Верно, если для проверки сертификатов веб-перехватчика был предоставлен настраиваемый сертификат
pending_update_count Целое число Количество обновлений, ожидающих доставки
ip_адрес Строка Необязательно .Текущий IP-адрес веб-перехватчика
last_error_date Целое число Необязательно . Время Unix для самой последней ошибки, которая произошла при попытке доставить обновление через webhook
last_error_message Строка Необязательно . Сообщение об ошибке в удобочитаемом формате для самой последней ошибки, произошедшей при попытке доставить обновление через webhook
max_connections Целое число Необязательно .Максимально допустимое количество одновременных HTTPS-подключений к веб-перехватчику для доставки обновлений
allowed_updates Массив строк Необязательно . Список типов обновлений, на которые подписан бот. По умолчанию для всех типов обновлений

Доступные типы

Все типы, используемые в ответах Bot API, представлены как JSON-объекты.

Можно безопасно использовать 32-разрядные целые числа со знаком для хранения всех полей Integer , если не указано иное.

Необязательные поля могут не возвращаться, если они неактуальны.

Пользователь

Этот объект представляет пользователя или бота Telegram.

Поле Тип Описание
id Целое число Уникальный идентификатор этого пользователя или бота
is_bot логический Верно, если этот пользователь бот
first_name Строка Имя пользователя или бота
фамилия Строка Необязательно .Фамилия пользователя или бота
имя пользователя Строка Необязательно . Имя пользователя или бота
language_code Строка Необязательно . Языковой тег IETF языка пользователя
can_join_groups логический Необязательно . Правда, если бота можно приглашать в группы. Вернулся только в getMe.
can_read_all_group_messages логический Необязательно .Верно, если для бота отключен приватный режим. Вернулся только в getMe.
supports_inline_queries логический Необязательно . Правда, если бот поддерживает встроенные запросы. Вернулся только в getMe.
Чат

Этот объект представляет чат.

Фото
Поле Тип Описание
id Целое число Уникальный идентификатор этого чата.Это число может быть больше 32 бит, и некоторые языки программирования могут иметь затруднительные / скрытые дефекты при его интерпретации. Но он меньше 52 бит, поэтому 64-битное целое число со знаком или плавающий тип двойной точности безопасны для хранения этого идентификатора.
тип Строка Тип чата, может быть «частным», «групповым», «супергрупповым» или «канальным»
название Строка Необязательно . Заголовок, для супергрупп, каналов и групповых чатов
имя пользователя Строка Необязательно .Имя пользователя, для приватных чатов, супергрупп и каналов, если есть
first_name Строка Необязательно . Имя собеседника в приватном чате
фамилия Строка Необязательно . Фамилия собеседника в приватном чате
фото ChatPhoto Необязательно . Фото чата. Вернул только в getChat.
био Строка Необязательно .Биография собеседника в приватном чате. Вернул только в getChat.
описание Строка Необязательно . Описание, для групп, супергрупп и чатов каналов. Вернул только в getChat.
invit_link Строка Необязательно . Ссылка для приглашения в чат для групп, супергрупп и чатов каналов. Каждый администратор в чате генерирует свои собственные пригласительные ссылки, поэтому бот должен сначала создать ссылку с помощью exportChatInviteLink.Вернул только в getChat.
pinned_message Сообщение Необязательно . Последнее закрепленное сообщение (по дате отправки). Вернул только в getChat.
разрешения Разрешения для чата Необязательно . Разрешения участников чата по умолчанию для групп и супергрупп. Вернул только в getChat.
slow_mode_delay Целое число Необязательно .Для супергрупп — минимально допустимая задержка между последовательными сообщениями, отправляемыми каждым непривилегированным пользователем. Вернул только в getChat.
имя_набора_наклей Строка Необязательно . Для супергрупп — название набора групповых стикеров. Вернул только в getChat.
can_set_sticker_set логический Необязательно . Правда, если бот умеет менять групповой набор стикеров. Вернул только в getChat.
connected_chat_id Целое число Необязательно .Уникальный идентификатор связанного чата, то есть идентификатор группы обсуждения для канала и наоборот; для супергрупп и чатов каналов. Длина этого идентификатора может превышать 32 бита, и некоторые языки программирования могут иметь затруднительные / скрытые дефекты при его интерпретации. Но он меньше 52 бит, поэтому 64-битное целое число со знаком или плавающий тип двойной точности безопасны для хранения этого идентификатора. Вернул только в getChat.
местонахождение чат, местонахождение Необязательно .Для супергрупп — место, к которому подключается супергруппа. Вернул только в getChat.
Сообщение

Этот объект представляет сообщение.

.
Поле Тип Описание
message_id Целое число Уникальный идентификатор сообщения в этом чате
из Пользователь Необязательно . Отправитель, пусто для сообщений, отправленных на каналы
sender_chat Чат Необязательно .Отправитель сообщения, отправленного от имени чата. Сам канал для сообщений канала. Сама супергруппа для сообщений от администраторов анонимных групп. Связанный канал для сообщений, автоматически перенаправляемых в группу обсуждения
дата Целое число Дата отправки сообщения по времени Unix
чат Чат Цепочка, которой принадлежит сообщение
вперед_от Пользователь Необязательно .Для пересылаемых сообщений отправитель исходного сообщения
вперед_from_chat Чат Необязательно . Для сообщений, пересылаемых с каналов или от анонимных администраторов, информация об исходном чате отправителя
forward_from_message_id Целое число Необязательно . Для сообщений, пересылаемых из каналов, идентификатор исходного сообщения в канале
forward_signature Строка Необязательно .Для сообщений, пересылаемых с каналов, подпись автора сообщения при его наличии
forward_sender_name Строка Необязательно . Имя отправителя сообщений, пересылаемых от пользователей, которые запрещают добавлять ссылку на свою учетную запись в пересылаемых сообщениях
forward_date Целое число Необязательно . Для перенаправленных сообщений дата отправки исходного сообщения в Unix-времени
reply_to_message Сообщение Необязательно .Для ответов — исходное сообщение. Обратите внимание, что объект сообщения в этом поле не будет содержать дополнительных полей reply_to_message , даже если он сам является ответом.
via_bot Пользователь Необязательно . Бот, через который было отправлено сообщение
edit_date Целое число Необязательно . Дата последнего редактирования сообщения по времени Unix
media_group_id Строка Необязательно .Уникальный идентификатор группы мультимедийных сообщений, к которой принадлежит это сообщение
автор_подпись Строка Необязательно . Подпись автора сообщения для сообщений в каналах или настраиваемый заголовок анонимного администратора группы
текст Строка Необязательно . Для текстовых сообщений фактический текст сообщения в формате UTF-8, 0-4096 символов
юридических лиц Массив MessageEntity Необязательно .Для текстовых сообщений специальные объекты, такие как имена пользователей, URL-адреса, команды ботов и т. Д., Которые появляются в тексте
анимация Анимация Необязательно . Сообщение — это анимация, информация об анимации. Для обратной совместимости, когда это поле установлено, поле документа также будет установлено
аудио Аудио Необязательно . Сообщение — аудиофайл, информация о файле
документ Документ Необязательно .Сообщение — это общий файл, информация о файле
фото Массив PhotoSize Необязательно . В сообщении есть фото, доступные размеры фото
наклейка Наклейка Необязательно . Сообщение — наклейка, информация о наклейке
видео Видео Необязательно . Сообщение это видео, информация о видео
video_note VideoNote Необязательно .Сообщение — видеозаметка, информация о видео сообщении
голос Голос Необязательно . Сообщение — голосовое сообщение, информация о файле
подпись Строка Необязательно . Подпись к анимации, аудио, документу, фотографии, видео или голосу, 0-1024 символа
caption_entities Массив MessageEntity Необязательно .Для сообщений с заголовком в заголовке используются специальные объекты, такие как имена пользователей, URL-адреса, команды ботов и т. Д.
контакт Контакт Необязательно . Сообщение — общий контакт, информация о контакте
игральные кости Кости Необязательно . Сообщение — игральная кость со случайным значением
игра Игра Необязательно . Сообщение — это игра, информация об игре.Подробнее об играх »
опрос Опрос Необязательно . Сообщение — нативный опрос, информация о опросе
площадка Заведение Необязательно . Сообщение — это место проведения, информация о месте проведения. Для обратной совместимости, когда это поле установлено, в поле расположения также будет установлено значение
местонахождение Расположение Необязательно .Сообщение является общим местоположением, информация о местоположении
new_chat_members Массив пользователей Необязательно . Новые участники, которые были добавлены в группу или супергруппу, и информация о них (сам бот может быть одним из этих участников)
left_chat_member Пользователь Необязательно . Участник удален из группы, информация о нем (этим участником может быть сам бот)
new_chat_title Строка Необязательно .Название чата было изменено на это значение
new_chat_photo Массив PhotoSize Необязательно . Фотография чата была изменена на это значение
delete_chat_photo Истинно Необязательно . Служебное сообщение: фото чата удалено
group_chat_created Истинно Необязательно . Служебное сообщение: группа создана
supergroup_chat_created Истинно Необязательно .Служебное сообщение: супергруппа создана. Это поле нельзя получить в сообщении, приходящем через обновления, потому что бот не может быть членом супергруппы при ее создании. Его можно найти в reply_to_message только в том случае, если кто-то отвечает на самое первое сообщение в непосредственно созданной супергруппе.
channel_chat_created Истинно Необязательно . Служебное сообщение: канал создан. Это поле не может быть получено в сообщении, приходящем через обновления, потому что бот не может быть участником канала при его создании.Его можно найти в reply_to_message, только если кто-то отвечает на самое первое сообщение в канале.
migrate_to_chat_id Целое число Необязательно . Группа была перенесена в супергруппу с указанным идентификатором. Это число может быть больше 32 бит, и некоторые языки программирования могут иметь затруднительные / скрытые дефекты при его интерпретации. Но он меньше 52 бит, поэтому 64-битное целое число со знаком или плавающий тип двойной точности безопасны для хранения этого идентификатора.
migrate_from_chat_id Целое число Необязательно . Супергруппа была перенесена из группы с указанным идентификатором. Это число может быть больше 32 бит, и некоторые языки программирования могут иметь затруднительные / скрытые дефекты при его интерпретации. Но он меньше 52 бит, поэтому 64-битное целое число со знаком или плавающий тип двойной точности безопасны для хранения этого идентификатора.
pinned_message Сообщение Необязательно .Указанное сообщение закреплено. Обратите внимание, что объект сообщения в этом поле не будет содержать дополнительных полей reply_to_message , даже если он сам является ответом.
счет-фактура Счет-фактура Необязательно . Сообщение — это счет на оплату, информация о счете. Подробнее о платежах »
успешный_платеж Успешный платеж Необязательно . Сообщение — служебное сообщение об успешном платеже, информация о платеже.Подробнее о платежах »
connected_website Строка Необязательно . Доменное имя сайта, на котором зарегистрировался пользователь. Подробнее о Telegram Login »
паспортные_данные Паспорт Данные Необязательно . Telegram Паспортные данные
близости_alert_triggered ProximityAlertTriggered Необязательно . Сервисное сообщение. Пользователь в чате активировал оповещение о близости другого пользователя, когда делился своим местоположением в реальном времени.
reply_markup InlineKeyboardMarkup Необязательно . Встроенная клавиатура, прикрепленная к сообщению. login_url кнопки представлены как обычные кнопки url .
Идентификатор сообщения

Этот объект представляет уникальный идентификатор сообщения.

Поле Тип Описание
message_id Целое число Уникальный идентификатор сообщения
MessageEntity

Этот объект представляет одну особую сущность в текстовом сообщении.Например, хэштеги, имена пользователей, URL-адреса и т. Д.

Поле Тип Описание
тип Строка Тип юридического лица. Может быть «упоминание» ( @username ), «hashtag» ( #hashtag ), «cashtag» ( $ долларов США), «bot_command» ( / start @ jobs_bot ), «url» ( https : //telegram.org ), «электронная почта» ( [email protected] ), «phone_number» ( + 1-212-555-0123 ), «жирный» ( жирный текст ), «Курсив» ( курсивный текст ), «подчеркнутый» (подчеркнутый текст), «зачеркнутый» (зачеркнутый текст), «код» (строка с одной шириной), «pre» (блок с одной шириной), «текст_ссылка» (для кликабельной текстовые URL-адреса), «text_mention» (для пользователей без имен пользователей)
смещение Целое число Смещение в единицах кода UTF-16 до начала объекта
длина Целое число Длина объекта в единицах кода UTF-16
url Строка Необязательно .Только для «text_link»: URL, который будет открыт после того, как пользователь нажмет на текст
пользователь Пользователь Необязательно . Только для «text_mention» указанный пользователь
язык Строка Необязательно . Только для «pre», язык программирования текста объекта
Размер фото

Этот объект представляет собой фотографию одного размера или эскиз файла / стикера.

Поле Тип Описание
file_id Строка Идентификатор этого файла, который можно использовать для загрузки или повторного использования файла
file_unique_id Строка Уникальный идентификатор этого файла, который должен быть одинаковым во времени и для разных ботов. Невозможно использовать для загрузки или повторного использования файла.
ширина Целое число Ширина фото
высота Целое число Высота фото
размер_файла Целое число Необязательно .Размер файла
Анимация

Этот объект представляет файл анимации (видео в формате GIF или H.264 / MPEG-4 AVC без звука).

Размер фото
Поле Тип Описание
file_id Строка Идентификатор этого файла, который можно использовать для загрузки или повторного использования файла
file_unique_id Строка Уникальный идентификатор этого файла, который должен быть одинаковым во времени и для разных ботов.Невозможно использовать для загрузки или повторного использования файла.
ширина Целое число Ширина видео, определенная отправителем
высота Целое число Высота видео, определенная отправителем
продолжительность Целое число Продолжительность видео в секундах, определенная отправителем
большой палец Необязательно . Миниатюра анимации, определенная отправителем
имя_файла Строка Необязательно .Исходное имя файла анимации, определенное отправителем
mime_type Строка Необязательно . MIME-тип файла, определенный отправителем
размер_файла Целое число Необязательно . Размер файла
Аудио

Этот объект представляет аудиофайл, который клиенты Telegram будут рассматривать как музыку.

Размер фото
Поле Тип Описание
file_id Строка Идентификатор этого файла, который можно использовать для загрузки или повторного использования файла
file_unique_id Строка Уникальный идентификатор этого файла, который должен быть одинаковым во времени и для разных ботов.Невозможно использовать для загрузки или повторного использования файла.
продолжительность Целое число Продолжительность звука в секундах, определенная отправителем
исполнитель Строка Необязательно . Исполнитель аудио, определенный отправителем или аудио тегами
название Строка Необязательно . Название аудио, определенное отправителем или тегами аудио
имя_файла Строка Необязательно .Исходное имя файла, определенное отправителем
mime_type Строка Необязательно . MIME-тип файла, определенный отправителем
размер_файла Целое число Необязательно . Размер файла
большой палец Необязательно . Миниатюра обложки альбома, к которому принадлежит музыкальный файл
Документ

Этот объект представляет собой общий файл (в отличие от фотографий, голосовых сообщений и аудиофайлов).

Размер фото
Поле Тип Описание
file_id Строка Идентификатор этого файла, который можно использовать для загрузки или повторного использования файла
file_unique_id Строка Уникальный идентификатор этого файла, который должен быть одинаковым во времени и для разных ботов. Невозможно использовать для загрузки или повторного использования файла.
большой палец Необязательно .Миниатюра документа, определенная отправителем
имя_файла Строка Необязательно . Исходное имя файла, определенное отправителем
mime_type Строка Необязательно . MIME-тип файла, определенный отправителем
размер_файла Целое число Необязательно . Размер файла
Видео

Этот объект представляет видеофайл.

Размер фото
Поле Тип Описание
file_id Строка Идентификатор этого файла, который можно использовать для загрузки или повторного использования файла
file_unique_id Строка Уникальный идентификатор этого файла, который должен быть одинаковым во времени и для разных ботов. Невозможно использовать для загрузки или повторного использования файла.
ширина Целое число Ширина видео, определенная отправителем
высота Целое число Высота видео, определенная отправителем
продолжительность Целое число Продолжительность видео в секундах, определенная отправителем
большой палец Необязательно .Миниатюра видео
имя_файла Строка Необязательно . Исходное имя файла, определенное отправителем
mime_type Строка Необязательно . Mime-тип файла, определенный отправителем
размер_файла Целое число Необязательно . Размер файла
VideoNote

Этот объект представляет собой видеосообщение (доступно в приложениях Telegram начиная с v.4.0).

Размер фото
Поле Тип Описание
file_id Строка Идентификатор этого файла, который можно использовать для загрузки или повторного использования файла
file_unique_id Строка Уникальный идентификатор этого файла, который должен быть одинаковым во времени и для разных ботов. Невозможно использовать для загрузки или повторного использования файла.
длина Целое число Ширина и высота видео (диаметр видео сообщения), определенные отправителем
продолжительность Целое число Продолжительность видео в секундах, определенная отправителем
большой палец Необязательно .Миниатюра видео
размер_файла Целое число Необязательно . Размер файла
Голос

Этот объект представляет голосовую заметку.

Поле Тип Описание
file_id Строка Идентификатор этого файла, который можно использовать для загрузки или повторного использования файла
file_unique_id Строка Уникальный идентификатор этого файла, который должен быть одинаковым во времени и для разных ботов.Невозможно использовать для загрузки или повторного использования файла.
продолжительность Целое число Продолжительность звука в секундах, определенная отправителем
mime_type Строка Необязательно . MIME-тип файла, определенный отправителем
размер_файла Целое число Необязательно . Размер файла
Связаться

Этот объект представляет телефонный контакт.

Поле Тип Описание
телефонный номер Строка Телефон контакта
first_name Строка Имя контакта
фамилия Строка Необязательно . Фамилия контакта
user_id Целое число Необязательно .Идентификатор пользователя контакта в Telegram
визитка Строка Необязательно . Дополнительные данные о контакте в виде vCard
Кости

Этот объект представляет собой анимированный смайлик, отображающий случайное значение.

Опция опроса

Этот объект содержит информацию об одном варианте ответа в опросе.

Поле Тип Описание
текст Строка Текст опции, 1–100 знаков
voter_count Целое число Количество пользователей, проголосовавших за этот вариант
Ответ на опрос

Этот объект представляет собой ответ пользователя в неанонимном опросе.

Поле Тип Описание
poll_id Строка Уникальный идентификатор опроса
пользователь Пользователь Пользователь, изменивший ответ на опрос
option_ids Массив целых чисел 0 идентификаторов вариантов ответа, выбранных пользователем. Может быть пустым, если пользователь отозвал свой голос.
Опрос

Этот объект содержит информацию об опросе.

Поле Тип Описание
id Строка Уникальный идентификатор опроса
вопрос Строка Вопрос опроса, 1-300 знаков
варианты Массив вариантов опроса Список вариантов опроса
total_voter_count Целое число Общее количество пользователей, проголосовавших в опросе
закрыто логический Верно, если опрос закрыт
is_anonymous логический Верно, если опрос анонимный
тип Строка Тип опроса, в настоящее время может быть «обычный» или «викторина»
allow_multiple_answers логический Верно, если опрос допускает несколько ответов
правильный_ идентификатор_опции Целое число Необязательно .Отсчитываемый от 0 идентификатор правильного варианта ответа. Доступно только для опросов в режиме викторины, которые закрыты, были отправлены (не перенаправлены) ботом или в приватный чат с ботом.
объяснение Строка Необязательно . Текст, который отображается, когда пользователь выбирает неправильный ответ или нажимает на значок лампы в опросе в стиле викторины, 0-200 символов
description_entities Массив MessageEntity Необязательно .Специальные объекты, такие как имена пользователей, URL-адреса, команды ботов и т. Д., Которые появляются в объяснении
open_period Целое число Необязательно . Время в секундах, в течение которого опрос будет активен после создания
close_date Целое число Необязательно . Момент времени (временная метка Unix), когда опрос будет автоматически закрыт
Расположение

Этот объект представляет точку на карте.

Поле Тип Описание
долгота Поплавок Долгота, определенная отправителем
широта Поплавок Широта, определенная отправителем
горизонтальная_точность Число с плавающей запятой Необязательно . Радиус неопределенности местоположения, измеряемый в метрах; 0-1500
live_period Целое число Необязательно .Время относительно даты отправки сообщения, в течение которого местоположение может быть обновлено, в секундах. Только для активных живых локаций.
товарная позиция Целое число Необязательно . Направление, в котором движется пользователь, в градусах; 1-360. Только для активных живых локаций.
Distance_alert_radius Целое число Необязательно . Максимальное расстояние для оповещений о приближении к другому участнику чата в метрах.Только для отправленных живых местоположений.
Место проведения

Этот объект представляет собой место проведения.

Поле Тип Описание
местонахождение Расположение Расположение объекта. Не может быть живым местом
название Строка Название заведения
адрес Строка Адрес места проведения
foursquare_id Строка Необязательно .Foursquare идентификатор места
foursquare_type Строка Необязательно . Тип площадки Foursquare. (Например, «arts_entertainment / default», «arts_entertainment / aquarium» или «food / icecream».)
google_place_id Строка Необязательно . Идентификатор места проведения в Google Places
google_place_type Строка Необязательно .Google Places тип места проведения. (См. Поддерживаемые типы.)
ProximityAlertTriggered

Этот объект представляет содержимое служебного сообщения, отправляемого всякий раз, когда пользователь в чате запускает оповещение о близости, установленное другим пользователем.

Поле Тип Описание
путешественник Пользователь Пользователь, вызвавший предупреждение
наблюдатель Пользователь Пользователь, установивший оповещение
расстояние Целое число Расстояние между пользователями
Профиль пользователя Фото

Этот объект представляет собой изображение профиля пользователя.

Поле Тип Описание
total_count Целое число Общее количество изображений профиля целевого пользователя
фото Массив массива PhotoSize Запрошенные изображения профиля (до 4 размеров каждое)
Файл

Этот объект представляет файл, готовый к загрузке. Файл можно скачать по ссылке https: // api.telegram.org/file/bot/ . Гарантируется, что ссылка будет действительна не менее 1 часа. По истечении срока действия ссылки можно запросить новую, вызвав getFile.

Максимальный размер загружаемого файла — 20 МБ

Поле Тип Описание
file_id Строка Идентификатор этого файла, который можно использовать для загрузки или повторного использования файла
file_unique_id Строка Уникальный идентификатор этого файла, который должен быть одинаковым во времени и для разных ботов.Невозможно использовать для загрузки или повторного использования файла.
размер_файла Целое число Необязательно . Размер файла, если известен
file_path Строка Необязательно . Путь файла. Используйте https://api.telegram.org/file/bot/ , чтобы получить файл.
ОтветитьKeyboardMarkup

Этот объект представляет собой настраиваемую клавиатуру с параметрами ответа (подробности и примеры см. В разделе Знакомство с ботами).

Поле Тип Описание
клавиатура Массив массива KeyboardButton Массив строк кнопок, каждая из которых представлена ​​массивом объектов KeyboardButton
resize_keyboard логический Необязательно . Просит клиентов изменить размер клавиатуры по вертикали для оптимальной подгонки (например, сделать клавиатуру меньше, если есть только два ряда кнопок).По умолчанию false , и в этом случае настраиваемая клавиатура всегда имеет ту же высоту, что и стандартная клавиатура приложения.
one_time_keyboard логический Необязательно . Просит клиентов скрыть клавиатуру, как только она будет использована. Клавиатура по-прежнему будет доступна, но клиенты будут автоматически отображать обычную буквенную клавиатуру в чате — пользователь может нажать специальную кнопку в поле ввода, чтобы снова увидеть настраиваемую клавиатуру.По умолчанию false .
селективный логический Необязательно . Используйте этот параметр, если хотите показать клавиатуру только определенным пользователям. Цели: 1) пользователи, @ упомянутые в тексте объекта сообщения; 2) если сообщение бота является ответом (имеет reply_to_message_id ), отправитель исходного сообщения.

Пример: Пользователь запрашивает изменение языка бота, бот отвечает на запрос с помощью клавиатуры, чтобы выбрать новый язык.Другие пользователи в группе не видят клавиатуру.

Клавиатура

Этот объект представляет одну кнопку клавиатуры ответа. Для простых текстовых кнопок String может использоваться вместо этого объекта для указания текста кнопки. Необязательные поля request_contact , request_location и request_poll являются взаимоисключающими.

Поле Тип Описание
текст Строка Текст кнопки.Если ни одно из дополнительных полей не используется, оно будет отправлено в виде сообщения при нажатии кнопки
request_contact логический Необязательно . Если True , телефонный номер пользователя будет отправлен как контакт при нажатии кнопки. Доступно только в приватных чатах
request_location логический Необязательно . Если True , текущее местоположение пользователя будет отправлено при нажатии кнопки.Доступно только в приватных чатах
request_poll KeyboardButtonPollType Необязательно . Если указано, пользователю будет предложено создать опрос и отправить его боту при нажатии кнопки. Доступно только в приватных чатах

Примечание. Параметры request_contact и request_location будут работать только в версиях Telegram, выпущенных после 9 апреля 2016 года. Старые клиенты будут отображать неподдерживаемое сообщение .
Примечание. Параметр request_poll будет работать только в версиях Telegram, выпущенных после 23 января 2020 года. Старые клиенты будут отображать неподдерживаемое сообщение .

KeyboardButtonPollType

Этот объект представляет тип опроса, который может быть создан и отправлен при нажатии соответствующей кнопки.

Поле Тип Описание
тип Строка Необязательно .Если тест пройден, пользователю будет разрешено создавать только опросы в режиме викторины. Если обычный пройден, будут разрешены только обычные опросы. В противном случае пользователю будет разрешено создать опрос любого типа.
ОтветитьKeyboardRemove

При получении сообщения с этим объектом клиенты Telegram удаляют текущую настраиваемую клавиатуру и отображают буквенную клавиатуру по умолчанию. По умолчанию настраиваемые клавиатуры отображаются до тех пор, пока бот не отправит новую клавиатуру.Исключение составляет одноразовая клавиатура, которая скрывается сразу после нажатия кнопки пользователем (см. ReplyKeyboardMarkup).

Поле Тип Описание
remove_keyboard Истинно Запрашивает клиентов удалить настраиваемую клавиатуру (пользователь не сможет вызвать эту клавиатуру; если вы хотите скрыть клавиатуру от глаз, но сохранить ее доступной, используйте one_time_keyboard в ReplyKeyboardMarkup)
селективный логический Необязательно .Используйте этот параметр, если вы хотите удалить клавиатуру только для определенных пользователей. Цели: 1) пользователи, @ упомянутые в тексте объекта сообщения; 2) если сообщение бота является ответом (имеет reply_to_message_id ), отправитель исходного сообщения.

Пример: Пользователь голосует в опросе, бот возвращает подтверждающее сообщение в ответ на голосование и удаляет клавиатуру этого пользователя, при этом показывая клавиатуру с параметрами опроса пользователям, которые еще не проголосовали.

InlineKeyboardMarkup

Этот объект представляет собой встроенную клавиатуру, которая отображается рядом с сообщением, которому она принадлежит.

Примечание: Это будет работать только в версиях Telegram, выпущенных после 9 апреля 2016 года. Старые клиенты будут отображать неподдерживаемое сообщение .

InlineKeyboardButton

Этот объект представляет одну кнопку встроенной клавиатуры. Вы должны использовать ровно одно из необязательных полей.

Поле Тип Описание
текст Строка Текст надписи на кнопке
url Строка Необязательно . HTTP или tg: // URL, который открывается при нажатии кнопки
login_url LoginUrl Необязательно . URL-адрес HTTP, используемый для автоматической авторизации пользователя. Может использоваться как замена виджета входа в Telegram.
callback_data Строка Необязательно . Данные для отправки боту в ответном запросе при нажатии кнопки, 1-64 байта
switch_inline_query Строка Необязательно . Если установлено, нажатие кнопки предложит пользователю выбрать один из своих чатов, открыть этот чат и вставить имя пользователя бота и указанный встроенный запрос в поле ввода. Может быть пустым, и в этом случае будет вставлено только имя пользователя бота.

Примечание: Это дает пользователям простой способ начать использовать вашего бота во встроенном режиме, когда они в настоящее время находятся с ним в приватном чате. Особенно полезно в сочетании с действиями switch_pm… — в этом случае пользователь автоматически вернется в чат, из которого он переключился, пропуская экран выбора чата.

switch_inline_query_current_chat Строка Необязательно . Если установлено, нажатие кнопки вставит имя пользователя бота и указанный встроенный запрос в поле ввода текущего чата.Может быть пустым, и в этом случае будет вставлено только имя пользователя бота.

Это дает пользователю быстрый способ открыть вашего бота во встроенном режиме в том же чате — удобно для выбора чего-либо из нескольких вариантов.

callback_game Обратный звонокИгра Необязательно . Описание игры, которая будет запускаться при нажатии пользователем кнопки.

ПРИМЕЧАНИЕ: Кнопка этого типа должна всегда быть первой кнопкой в ​​первом ряду.

плати логический Необязательно . Укажите True, чтобы отправить кнопку Pay.

ПРИМЕЧАНИЕ: Кнопка этого типа должна всегда быть первой кнопкой в ​​первом ряду.

LoginUrl

Этот объект представляет параметр встроенной кнопки клавиатуры, используемой для автоматической авторизации пользователя. Служит отличной заменой виджета входа в Telegram, когда пользователь переходит из Telegram.Все, что нужно сделать пользователю, это нажать / щелкнуть кнопку и подтвердить, что он хочет войти в систему:

Приложения

Telegram поддерживают эти кнопки начиная с версии 5.7.

Пример бота: @discussbot

Поле Тип Описание
url Строка URL-адрес HTTP, который должен быть открыт с данными авторизации пользователя, добавленными в строку запроса при нажатии кнопки. Если пользователь отказывается предоставить данные авторизации, будет открыт исходный URL без информации о пользователе.Добавленные данные такие же, как описано в разделе Получение данных авторизации.

ПРИМЕЧАНИЕ. Вы, , должны всегда проверять хэш полученных данных для проверки аутентификации и целостности данных, как описано в разделе Проверка авторизации.

forward_text Строка Необязательно . Новый текст кнопки в перенаправленных сообщениях.
bot_username Строка Необязательно .Логин бота, который будет использоваться для авторизации пользователя. См. Подробности в разделе «Настройка бота». Если не указано, будет использоваться имя текущего бота. Домен url ​​ должен быть таким же, как домен, связанный с ботом. Дополнительные сведения см. В разделе «Связывание домена с ботом».
request_write_access логический Необязательно . Передайте True, чтобы запросить у вашего бота разрешение на отправку сообщений пользователю.
Обратный звонок Запрос

Этот объект представляет входящий запрос обратного вызова от кнопки обратного вызова на встроенной клавиатуре.Если кнопка, инициировавшая запрос, была прикреплена к сообщению, отправляемому ботом, поле сообщение будет присутствовать. Если кнопка была прикреплена к сообщению, отправленному через бота (во встроенном режиме), поле inline_message_id будет присутствовать. Ровно одно из полей data или game_short_name будет присутствовать.

Поле Тип Описание
id Строка Уникальный идентификатор этого запроса
из Пользователь Отправитель
сообщение Сообщение Необязательно .Сообщение с кнопкой обратного вызова, которая инициировала запрос. Обратите внимание, что содержание сообщения и дата сообщения будут недоступны, если сообщение слишком старое
inline_message_id Строка Необязательно . Идентификатор сообщения, отправленного через бот во встроенном режиме, из которого был сделан запрос.
chat_instance Строка Глобальный идентификатор, однозначно соответствующий чату, в который было отправлено сообщение с кнопкой обратного вызова.Полезно для высоких результатов в играх.
данные Строка Необязательно . Данные, связанные с кнопкой обратного вызова. Имейте в виду, что плохой клиент может отправлять произвольные данные в это поле.
game_short_name Строка Необязательно . Краткое название игры, которое должно быть возвращено, служит уникальным идентификатором для игры

ПРИМЕЧАНИЕ. После того, как пользователь нажмет кнопку обратного вызова, клиенты Telegram будут отображать индикатор выполнения, пока вы не вызовете answerCallbackQuery.Следовательно, необходимо реагировать путем вызова answerCallbackQuery, даже если уведомление для пользователя не требуется (например, без указания каких-либо дополнительных параметров).

ForceReply

При получении сообщения с этим объектом клиенты Telegram отобразят интерфейс ответа для пользователя (действуют так, как если бы пользователь выбрал сообщение бота и нажал «Ответить»). Это может быть чрезвычайно полезно, если вы хотите создавать удобные пошаговые интерфейсы, не жертвуя режимом конфиденциальности.

Поле Тип Описание
force_reply Истинно Показывает интерфейс ответа для пользователя, как если бы он вручную выбрал сообщение бота и нажал «Ответить»
селективный логический Необязательно . Используйте этот параметр, если вы хотите принудительно отвечать только определенным пользователям. Цели: 1) пользователи, @ упомянутые в тексте объекта сообщения; 2) если сообщение бота является ответом (имеет reply_to_message_id ), отправитель исходного сообщения.

Пример: Бот для опроса групп работает в режиме конфиденциальности (только принимает команды, отвечает на свои сообщения и упоминает). Создать новый опрос может двумя способами:

  • Объясните пользователю, как отправить команду с параметрами (например, / newpoll question answer1 answer2). Может быть привлекательным для заядлых пользователей, но ему не хватает современного блеска.
  • Проведите пользователя через пошаговые инструкции. «Пожалуйста, пришлите мне свой вопрос», «Круто, теперь давайте добавим первый вариант ответа», «Отлично.Продолжайте добавлять варианты ответа, а затем отправьте / готово, когда будете готовы ».

Последний вариант однозначно более привлекательный. И если вы используете ForceReply в вопросах своего бота, он будет получать ответы пользователя, даже если он получает только ответы, команды и упоминания — без дополнительной работы для пользователя.

Чат Фото

Этот объект представляет собой фотографию чата.

Поле Тип Описание
small_file_id Строка Идентификатор файла небольшой (160×160) фотографии чата.Этот file_id можно использовать только для загрузки фотографий и только до тех пор, пока фотография не будет изменена.
small_file_unique_id Строка Уникальный идентификатор файла небольшой (160×160) фотографии чата, которая должна быть одинаковой с течением времени и для разных ботов. Невозможно использовать для загрузки или повторного использования файла.
big_file_id Строка Идентификатор файла большой фотографии чата (640×640). Этот file_id можно использовать только для загрузки фотографий и только до тех пор, пока фотография не будет изменена.
big_file_unique_id Строка Уникальный идентификатор файла большой (640×640) фотографии чата, который должен быть одинаковым во времени и для разных ботов. Невозможно использовать для загрузки или повторного использования файла.
Член чата

Этот объект содержит информацию об одном участнике чата.

Поле Тип Описание
пользователь Пользователь Информация о пользователе
статус Строка Статус участника в чате.Может быть «создатель», «администратор», «участник», «ограничен», «оставлен» или «исключен»
custom_title Строка Необязательно . Только владелец и администраторы. Пользовательское название для этого пользователя
is_anonymous логический Необязательно . Только владелец и администраторы. Правда, если присутствие пользователя в чате скрыто
can_be_edited логический Необязательно .Только администраторы. Верно, если боту разрешено редактировать права администратора этого пользователя
can_post_messages логический Необязательно . Только администраторы. Правда, если администратор может оставлять сообщения в канале; только каналы
can_edit_messages логический Необязательно . Только администраторы. Правда, если администратор может редактировать сообщения других пользователей и может закреплять сообщения; только каналы
can_delete_messages логический Необязательно .Только администраторы. Правда, если администратор может удалять сообщения других пользователей
can_restrict_members логический Необязательно . Только администраторы. Правда, если администратор может ограничивать, банить или разблокировать участников чата
can_promote_members логический Необязательно . Только администраторы. Верно, если администратор может добавлять новых администраторов с подмножеством их собственных привилегий или понижать в должности администраторов, которых он повысил, прямо или косвенно (продвинутых администраторами, назначенными пользователем)
can_change_info логический Необязательно .Только администраторы и с ограничениями. Правда, если пользователю разрешено менять название чата, фото и другие настройки
can_invite_users логический Необязательно . Только администраторы и с ограничениями. Верно, если пользователю разрешено приглашать новых пользователей в чат
can_pin_messages логический Необязательно . Только администраторы и с ограничениями. Истинно, если пользователю разрешено закреплять сообщения; только группы и супергруппы
член логический Необязательно .Только с ограничениями. Верно, если пользователь является участником чата на момент запроса
can_send_messages логический Необязательно . Только с ограничениями. Верно, если пользователю разрешено отправлять текстовые сообщения, контакты, места и места проведения
can_send_media_messages логический Необязательно . Только с ограничениями. Верно, если пользователю разрешено отправлять аудио, документы, фотографии, видео, видеозаметки и голосовые заметки
can_send_polls логический Необязательно .Только с ограничениями. Правда, если пользователю разрешено отправлять опросы
can_send_other_messages логический Необязательно . Только с ограничениями. Верно, если пользователю разрешено отправлять анимацию, игры, стикеры и использовать встроенных ботов
can_add_web_page_previews логический Необязательно . Только с ограничениями. Верно, если пользователю разрешено добавлять превью веб-страниц в свои сообщения
до_дата Целое число Необязательно .Только с ограничениями и пинками. Дата снятия ограничений для этого пользователя; unix time
Разрешения для чата

Описывает действия, которые пользователь без прав администратора может выполнять в чате.

Поле Тип Описание
can_send_messages логический Необязательно . Верно, если пользователю разрешено отправлять текстовые сообщения, контакты, места и места проведения
can_send_media_messages логический Необязательно .Правда, если пользователю разрешено отправлять аудио, документы, фотографии, видео, видеозаметки и голосовые заметки, подразумевается can_send_messages
can_send_polls логический Необязательно . Правда, если пользователю разрешено отправлять опросы, подразумевается can_send_messages
can_send_other_messages логический Необязательно . Правда, если пользователю разрешено отправлять анимацию, игры, стикеры и использовать встроенных ботов, подразумевается can_send_media_messages
can_add_web_page_previews логический Необязательно .Верно, если пользователю разрешено добавлять превью веб-страниц в свои сообщения, подразумевается can_send_media_messages
can_change_info логический Необязательно . Верно, если пользователю разрешено менять название чата, фото и другие настройки. Игнорируется в публичных супергруппах
can_invite_users логический Необязательно . Верно, если пользователю разрешено приглашать новых пользователей в чат
can_pin_messages логический Необязательно .Верно, если пользователю разрешено закреплять сообщения. Игнорируется в публичных супергруппах
Chat Location

Представляет место, к которому подключен чат.

Поле Тип Описание
местонахождение Расположение Местоположение, к которому подключена супергруппа. Не может быть живым местом.
адрес Строка Адрес местонахождения; 1-64 символа, как определено владельцем чата
BotCommand

Этот объект представляет команду бота.

Поле Тип Описание
команда Строка Текст команды, 1-32 символа. Может содержать только строчные английские буквы, цифры и символы подчеркивания.
описание Строка Описание команды, 3–256 знаков.
Параметры отклика

Содержит информацию о том, почему запрос был неудачным.

Поле Тип Описание
migrate_to_chat_id Целое число Необязательно . Группа была перенесена в супергруппу с указанным идентификатором. Это число может быть больше 32 бит, и некоторые языки программирования могут иметь затруднительные / скрытые дефекты при его интерпретации. Но он меньше 52 бит, поэтому 64-битное целое число со знаком или плавающий тип двойной точности безопасны для хранения этого идентификатора.
retry_after Целое число Необязательно . В случае превышения контроля наводнения, количество секунд, оставшихся ждать перед повторением запроса
InputMedia

Этот объект представляет содержимое отправляемого мультимедийного сообщения. Это должно быть одно из

InputMediaPhoto

— фотография для отправки.

Поле Тип Описание
тип Строка Тип результата, должно быть фото
СМИ Строка Файл для отправки.Передайте file_id для отправки файла, который существует на серверах Telegram (рекомендуется), передайте URL-адрес HTTP для Telegram, чтобы получить файл из Интернета, или передайте «attach: // », чтобы загрузить новый, используя multipart / данные формы под именем . Подробнее об отправке файлов »
подпись Строка Необязательно . Подпись к отправляемой фотографии, 0–1024 символа после синтаксического анализа объектов
parse_mode Строка Необязательно .Режим разбора сущностей в подписи к фото. См. Дополнительные сведения в параметрах форматирования.
caption_entities Массив MessageEntity Необязательно . Список особых сущностей, которые появляются в заголовке, которые можно указать вместо parse_mode
InputMediaVideo

Представляет видео для отправки.

Поле Тип Описание
тип Строка Тип результата, должно быть видео
СМИ Строка Файл для отправки.Передайте file_id для отправки файла, который существует на серверах Telegram (рекомендуется), передайте URL-адрес HTTP для Telegram, чтобы получить файл из Интернета, или передайте «attach: // », чтобы загрузить новый, используя multipart / данные формы под именем . Подробнее об отправке файлов »
большой палец Входной файл или строка Необязательно . Миниатюра отправленного файла; можно игнорировать, если создание эскизов для файла поддерживается на стороне сервера.Миниатюра должна быть в формате JPEG и размером менее 200 КБ. Ширина и высота эскиза не должны превышать 320. Игнорируется, если файл не загружен с использованием multipart / form-data. Эскизы не могут быть повторно использованы и могут быть загружены только как новый файл, поэтому вы можете передать «attach: // », если эскиз был загружен с использованием multipart / form-data в . Подробнее об отправке файлов »
подпись Строка Необязательно .Подпись к отправляемому видео, 0–1024 символа после синтаксического анализа объектов
parse_mode Строка Необязательно . Режим разбора сущностей в подписи к видео. См. Дополнительные сведения в параметрах форматирования.
caption_entities Массив MessageEntity Необязательно . Список особых сущностей, которые появляются в заголовке, которые можно указать вместо parse_mode
ширина Целое число Необязательно .Ширина видео
высота Целое число Необязательно . Высота видео
продолжительность Целое число Необязательно . Длительность видео
supports_streaming логический Необязательно . Пройдите True , если загруженное видео подходит для потоковой передачи
InputMediaAnimation

Представляет файл анимации (GIF или H.264 / MPEG-4 AVC без звука) для отправки.

Поле Тип Описание
тип Строка Тип результата, должен быть анимация
СМИ Строка Файл для отправки. Передайте file_id для отправки файла, который существует на серверах Telegram (рекомендуется), передайте URL-адрес HTTP для Telegram, чтобы получить файл из Интернета, или передайте «attach: // », чтобы загрузить новый, используя multipart / данные формы под именем .Подробнее об отправке файлов »
большой палец Входной файл или строка Необязательно . Миниатюра отправленного файла; можно игнорировать, если создание эскизов для файла поддерживается на стороне сервера. Миниатюра должна быть в формате JPEG и размером менее 200 КБ. Ширина и высота эскиза не должны превышать 320. Игнорируется, если файл не загружен с использованием multipart / form-data. Эскизы не могут быть повторно использованы и могут быть загружены только как новый файл, поэтому вы можете передать «attach: // », если эскиз был загружен с использованием multipart / form-data в .Подробнее об отправке файлов »
подпись Строка Необязательно . Подпись к отправляемой анимации, 0-1024 символа после синтаксического анализа объектов
parse_mode Строка Необязательно . Режим разбора сущностей в заголовке анимации. См. Дополнительные сведения в параметрах форматирования.
caption_entities Массив MessageEntity Необязательно .Список особых сущностей, которые появляются в заголовке, которые можно указать вместо parse_mode
ширина Целое число Необязательно . Ширина анимации
высота Целое число Необязательно . Высота анимации
продолжительность Целое число Необязательно . Продолжительность анимации
InputMediaAudio

Представляет аудиофайл, который следует рассматривать как музыку для отправки.

Поле Тип Описание
тип Строка Тип результата, должен быть аудио
СМИ Строка Файл для отправки. Передайте file_id для отправки файла, который существует на серверах Telegram (рекомендуется), передайте URL-адрес HTTP для Telegram, чтобы получить файл из Интернета, или передайте «attach: // », чтобы загрузить новый, используя multipart / данные формы под именем .Подробнее об отправке файлов »
большой палец Входной файл или строка Необязательно . Миниатюра отправленного файла; можно игнорировать, если создание эскизов для файла поддерживается на стороне сервера. Миниатюра должна быть в формате JPEG и размером менее 200 КБ. Ширина и высота эскиза не должны превышать 320. Игнорируется, если файл не загружен с использованием multipart / form-data. Эскизы не могут быть повторно использованы и могут быть загружены только как новый файл, поэтому вы можете передать «attach: // », если эскиз был загружен с использованием multipart / form-data в .Подробнее об отправке файлов »
подпись Строка Необязательно . Заголовок отправляемого аудио, 0-1024 символа после синтаксического анализа объектов
parse_mode Строка Необязательно . Режим парсинга сущностей в аудиозаголовке. См. Дополнительные сведения в параметрах форматирования.
caption_entities Массив MessageEntity Необязательно .Список особых сущностей, которые появляются в заголовке, которые можно указать вместо parse_mode
продолжительность Целое число Необязательно . Продолжительность звука в секундах
исполнитель Строка Необязательно . Исполнитель аудио
название Строка Необязательно . Название аудио
InputMediaDocument

Представляет общий файл для отправки.

Поле Тип Описание
тип Строка Тип результата, должен быть документ
СМИ Строка Файл для отправки. Передайте file_id для отправки файла, который существует на серверах Telegram (рекомендуется), передайте URL-адрес HTTP для Telegram, чтобы получить файл из Интернета, или передайте «attach: // », чтобы загрузить новый, используя multipart / данные формы под именем .Подробнее об отправке файлов »
большой палец Входной файл или строка Необязательно . Миниатюра отправленного файла; можно игнорировать, если создание эскизов для файла поддерживается на стороне сервера. Миниатюра должна быть в формате JPEG и размером менее 200 КБ. Ширина и высота эскиза не должны превышать 320. Игнорируется, если файл не загружен с использованием multipart / form-data. Эскизы не могут быть повторно использованы и могут быть загружены только как новый файл, поэтому вы можете передать «attach: // », если эскиз был загружен с использованием multipart / form-data в .Подробнее об отправке файлов »
подпись Строка Необязательно . Заголовок отправляемого документа, 0-1024 символа после синтаксического анализа объектов
parse_mode Строка Необязательно . Режим разбора сущностей в заголовке документа. См. Дополнительные сведения в параметрах форматирования.
caption_entities Массив MessageEntity Необязательно .Список особых сущностей, которые появляются в заголовке, которые можно указать вместо parse_mode
disable_content_type_detection логический Необязательно . Отключает автоматическое определение типа содержимого на стороне сервера для файлов, загруженных с использованием multipart / form-data. Всегда верно, если документ отправляется в составе альбома.
Входной файл

Этот объект представляет содержимое файла для загрузки.Должен быть опубликован с использованием multipart / form-data обычным способом, при котором файлы загружаются через браузер.

Отправка файлов

Существует три способа отправки файлов (фотографии, наклейки, аудио, мультимедиа и т. Д.):

  1. Если файл уже хранится где-то на серверах Telegram, вам не нужно повторно загружать его: каждый файловый объект имеет поле file_id , просто передайте этот file_id в качестве параметра вместо загрузки. без ограничений для файлов, отправленных таким образом.
  2. Предоставьте Telegram URL-адрес HTTP для отправляемого файла. Telegram скачает и отправит файл. Максимальный размер 5 МБ для фотографий и не более 20 МБ для других типов контента.
  3. Разместите файл с помощью multipart / form-data обычным способом, при котором файлы загружаются через браузер. Максимальный размер 10 МБ для фотографий, 50 МБ для других файлов.

Отправка по file_id

  • Невозможно изменить тип файла при повторной отправке по file_id .Т.е. видео нельзя отправить как фотографию, фотографию нельзя отправить как документ и т. д.
  • Невозможно повторно отправить эскизы.
  • Повторная отправка фотографии с помощью file_id отправит все ее размеры.
  • file_id уникален для каждого отдельного бота, и не может передаваться от одного бота к другому.
  • file_id однозначно определяет файл, но файл может иметь разные действительные file_id s даже для одного и того же бота.

Отправка по URL

  • При отправке по URL-адресу целевой файл должен иметь правильный MIME-тип (например, audio / mpeg для sendAudio и т. Д.).
  • В sendDocument отправка по URL-адресу в настоящее время работает только для файлов gif, , pdf, и zip .
  • Для использования sendVoice файл должен иметь тип audio / ogg и иметь размер не более 1 МБ. Голосовые заметки от 1 до 20 МБ будут отправлены в виде файлов.
  • Могут работать и другие конфигурации, но мы не можем гарантировать, что они будут работать.
Объекты встроенного режима

Объекты и методы, используемые во встроенном режиме, описаны в разделе «Встроенный режим».

Доступные методы

Все методы в Bot API нечувствительны к регистру. Мы поддерживаем методы HTTP GET и POST . Используйте строку запроса URL-адреса или application / json или application / x-www-form-urlencoded или multipart / form-data для передачи параметров в запросах Bot API.
При успешном вызове будет возвращен JSON-объект, содержащий результат.

getMe

Простой метод проверки токена аутентификации вашего бота. Не требует параметров. Возвращает основную информацию о боте в виде объекта User.

выход

Используйте этот метод для выхода из облачного сервера API ботов перед локальным запуском бота. Вы должны выйти из бота перед его локальным запуском, иначе нет гарантии, что бот будет получать обновления.После успешного вызова вы можете сразу войти в систему на локальном сервере, но не сможете снова войти на сервер API облачного бота в течение 10 минут. В случае успеха возвращает True . Не требует параметров.

закрыть

Используйте этот метод, чтобы закрыть экземпляр бота перед перемещением его с одного локального сервера на другой. Перед вызовом этого метода необходимо удалить веб-перехватчик, чтобы бот больше не запускался после перезапуска сервера. Метод вернет ошибку 429 в первые 10 минут после запуска бота.В случае успеха возвращает True . Не требует параметров.

Отправить сообщение

Используйте этот метод для отправки текстовых сообщений. В случае успеха отправленное сообщение возвращается.

Параметр Тип Требуется Описание
chat_id Целое число или строка Есть Уникальный идентификатор целевого чата или имя пользователя целевого канала (в формате @channelusername )
текст Строка Есть Текст отправляемого сообщения, 1-4096 символов после синтаксического анализа объектов
parse_mode Строка Дополнительно Режим разбора сущностей в тексте сообщения.См. Дополнительные сведения в параметрах форматирования.
юридических лиц Массив MessageEntity Дополнительно Список особых сущностей, которые появляются в тексте сообщения, которые можно указать вместо parse_mode
disable_web_page_preview логический Дополнительно Отключает предварительный просмотр ссылок для ссылок в этом сообщении
disable_notification логический Дополнительно Бесшумная отправка сообщения.Пользователи получат уведомление без звука.
reply_to_message_id Целое число Дополнительно Если сообщение является ответом, идентификатор исходного сообщения
allow_sending_without_reply логический Дополнительно Pass True , если сообщение должно быть отправлено, даже если указанное ответное сообщение не найдено
reply_markup InlineKeyboardMarkup или ReplyKeyboardMarkup или ReplyKeyboardRemove или ForceReply Дополнительно Дополнительные возможности интерфейса.Сериализованный объект JSON для встроенной клавиатуры, настраиваемой клавиатуры ответа, инструкций по удалению клавиатуры ответа или принудительного ответа от пользователя.
Параметры форматирования

Bot API поддерживает базовое форматирование сообщений. Вы можете использовать полужирный, курсив, подчеркнутый и зачеркнутый текст, а также встроенные ссылки и предварительно отформатированный код в сообщениях ваших ботов. Клиенты Telegram будут отображать их соответственно. Вы можете использовать форматирование в стиле уценки или HTML.

Обратите внимание, что клиенты Telegram будут отображать для пользователя предупреждение перед открытием встроенной ссылки («Открыть эту ссылку?» Вместе с полным URL-адресом).

Сообщение

IT Essentials (версия 7.0) Глава 6 Ответы на экзамен

1. Техник хочет обновить драйвер сетевой карты для компьютера. В каком месте лучше всего найти новые драйверы для сетевой карты?

  • установочный носитель для Windows
  • сайт для Microsoft
  • Центр обновления Windows
  • установочный носитель, поставляемый с сетевой картой
  • сайт производителя сетевой карты *

2.Компьютеру назначается IP-адрес 169.254.33.16. Что можно сказать о компьютере, исходя из присвоенного адреса?

  • Он не может общаться вне своей сети. *
  • Он имеет общедоступный IP-адрес, преобразованный в частный IP-адрес.
  • Он может связываться с сетями внутри конкретной компании с помощью подсетей.
  • Он может общаться как в локальной сети, так и в Интернете.
  • Если компьютер настроен с использованием DHCP, но не может взаимодействовать с DHCP-сервером для получения IP-адреса, ОС Windows автоматически назначает локальный IP-адрес в диапазоне 169.254.0.0 к 169.254.255.255. Компьютер может связываться только с другими компьютерами, подключенными к той же сети 169.254.0.0/16, и не может связываться с компьютерами в другой сети.

    3. Заполните поле.
    Процесс, который беспроводной маршрутизатор использует для преобразования частного IP-адреса во внутреннем трафике в маршрутизируемый адрес для Интернета, называется….

    • NAT *
    • преобразование сетевых адресов *

    Беспроводные маршрутизаторы используют преобразование сетевых адресов для преобразования внутренних или частных адресов в маршрутизируемые в Интернете или общедоступные адреса.

    4. Компьютеру назначен IP-адрес 169.254.33.16. Какая команда запускает процесс запроса нового IP-адреса?

    • tracert
    • нспросмотр
    • чистый компьютер
    • ipconfig / релиз *
    • Принуждение ПК к освобождению привязки DHCP позволяет выполнить новую операцию запроса DHCP. Команды net, tracert и nslookup не влияют на конфигурацию DHCP.

      5.Какой протокол динамически назначает IP-адреса сетевым устройствам?

      6. Пользователи недавно установленной беспроводной сети жалуются на медленную передачу данных и частую потерю связи. Техник проверяет, правильно ли реализована безопасность беспроводной сети и нет ли доказательств присутствия неавторизованных пользователей в сети.

    Добавить комментарий

    Ваш адрес email не будет опубликован.