Source code for pyrogram.methods.phone.join_group_call
# Pyrogram - Telegram MTProto API Client Library for Python
# Copyright (C) 2017-present Dan <https://github.com/delivrance>
#
# This file is part of Pyrogram.
#
# Pyrogram is free software: you can redistribute it and/or modify
# it under the terms of the GNU Lesser General Public License as published
# by the Free Software Foundation, either version 3 of the License, or
# (at your option) any later version.
#
# Pyrogram is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU Lesser General Public License for more details.
#
# You should have received a copy of the GNU Lesser General Public License
# along with Pyrogram. If not, see <http://www.gnu.org/licenses/>.
from __future__ import annotations
import random
import pyrogram
from pyrogram import raw, types, utils
class JoinGroupCall:
async def join_group_call(
self: pyrogram.Client,
chat_id: int | str | raw.types.InputGroupCall | types.GroupCall,
params: str | raw.base.DataJSON | None = None,
join_as: int | str | raw.base.InputPeer | None = None,
muted: bool | None = None,
video_stopped: bool | None = None,
invite_hash: str | None = None,
public_key: int | None = None,
block: bytes | None = None,
) -> raw.base.Updates:
"""Join a group call / voice chat via MTProto signaling.
.. include:: /_includes/usable-by/users-bots.rst
Parameters:
chat_id (``int`` | ``str`` | :obj:`~pyrogram.types.GroupCall`):
Target chat ID or GroupCall object.
params (``str`` | :obj:`~pyrogram.raw.base.DataJSON`, *optional*):
Signaling parameters payload JSON string or DataJSON object.
If omitted, a fresh random WebRTC SSRC is generated automatically.
join_as (``int`` | ``str`` | :obj:`~pyrogram.raw.base.InputPeer`, *optional*):
Channel or identity to join as. Defaults to self.
muted (``bool``, *optional*):
Whether to join muted.
video_stopped (``bool``, *optional*):
Whether to join with video disabled.
invite_hash (``str``, *optional*):
Invite hash to speak in a muted channel voice chat.
public_key (``int``, *optional*):
Conference call public key.
block (``bytes``, *optional*):
Conference call initial block.
Returns:
:obj:`~pyrogram.raw.base.Updates`: Updates resulting from joining the call.
Example:
.. code-block:: python
await app.join_group_call(chat_id)
"""
if isinstance(chat_id, raw.types.InputGroupCall):
call_input = chat_id
elif hasattr(chat_id, "id") and hasattr(chat_id, "access_hash"):
call_input = raw.types.InputGroupCall(id=chat_id.id, access_hash=chat_id.access_hash)
else:
peer = await self.resolve_peer(chat_id)
full_chat = await self.invoke(
raw.functions.channels.GetFullChannel(channel=utils.get_input_channel(peer))
if isinstance(peer, (raw.types.InputPeerChannel, raw.types.InputChannel))
else raw.functions.messages.GetFullChat(chat_id=peer.chat_id)
)
call_input = full_chat.full_chat.call
if join_as is None:
input_join_as = raw.types.InputPeerSelf()
elif isinstance(join_as, raw.base.InputPeer):
input_join_as = join_as
else:
input_join_as = await self.resolve_peer(join_as)
current_params = params
for attempt in range(3):
if current_params is None:
ssrc = random.randint(10000000, 99999999)
param_obj = raw.types.DataJSON(
data=f'{{"ssrc": {ssrc}, "min_layer": 1, "max_layer": 92}}'
)
elif isinstance(current_params, str):
param_obj = raw.types.DataJSON(data=current_params)
else:
param_obj = current_params
try:
return await self.invoke(
raw.functions.phone.JoinGroupCall(
call=call_input,
join_as=input_join_as,
params=param_obj,
muted=muted,
video_stopped=video_stopped,
invite_hash=invite_hash,
public_key=public_key,
block=block,
)
)
except Exception as e:
if (
"GROUPCALL_SSRC_DUPLICATE_MUCH" in str(e)
or getattr(e, "ID", "") == "GROUPCALL_SSRC_DUPLICATE_MUCH"
) and attempt < 2:
current_params = None
continue
raise