PersonGroupPersonOperations Classe
Operações PersonGroupPersonOperations.
Não deve instanciar diretamente esta classe, mas criar uma instância de Cliente que irá criá-la por si e anexá-la como atributo.
- Herança
-
builtins.objectPersonGroupPersonOperations
Construtor
PersonGroupPersonOperations(client, config, serializer, deserializer)Parâmetros
- client
Cliente para pedidos de serviço.
- config
Configuração do cliente de serviço.
- serializer
Um serializador de modelo de objeto.
- deserializer
Um desserializador de modelo de objeto.
Métodos
| add_face_from_stream |
Adicione um rosto a uma pessoa a um grupo de pessoas para identificação facial ou verificação. Para lidar com uma imagem que contém vários rostos, o rosto de entrada pode ser especificado como uma imagem com um retângulo targetFace. Devolve umFaceId persistente que representa o rosto adicionado. Não será armazenada nenhuma imagem.
Apenas a funcionalidade de rosto extraído será armazenada no servidor até que PersonGroup PersonFace - Delete, PersonGroup Person - Delete ou PersonGroup - Delete seja chamado.
|
| add_face_from_url |
Adicione um rosto a uma pessoa a um grupo de pessoas para identificação facial ou verificação. Para lidar com uma imagem que contém vários rostos, o rosto de entrada pode ser especificado como uma imagem com um retângulo targetFace. Devolve umFaceId persistente que representa o rosto adicionado. Não será armazenada nenhuma imagem.
Apenas a funcionalidade de rosto extraído será armazenada no servidor até que PersonGroup PersonFace - Delete, PersonGroup Person - Delete ou PersonGroup - Delete seja chamado.
|
| create |
Crie uma nova pessoa num grupo de pessoas especificado. |
| delete |
Eliminar uma pessoa existente de um grupo de pessoas. A funcionalidade persistedFaceId, userData, nome da pessoa e rosto na entrada de pessoa será eliminada. |
| delete_face |
Elimine um rosto de uma pessoa num grupo de pessoas por personGroupId, personId e persistedFaceId especificados.
|
| get |
Obtenha as informações de uma pessoa, incluindo rostos persistentes registados, nome e userData. |
| get_face |
Obtenha informações sobre um rosto persistente (especificado por persistedFaceId, personId e o respetivo personGroupId pertencente). |
| list |
Liste todas as pessoas num grupo de pessoas e obtenha as informações da pessoa (incluindo personId, name, userData e persistedFaceIds dos rostos registados da pessoa). |
| update |
Atualizar nome ou userData de uma pessoa. |
| update_face |
Adicione um rosto a uma pessoa a um grupo de pessoas para identificação facial ou verificação. Para lidar com uma imagem que contém vários rostos, o rosto de entrada pode ser especificado como uma imagem com um retângulo targetFace. Devolve umFaceId persistente que representa o rosto adicionado. Não será armazenada nenhuma imagem.
Apenas a funcionalidade de rosto extraído será armazenada no servidor até que PersonGroup PersonFace - Delete, PersonGroup Person - Delete ou PersonGroup - Delete seja chamado.
|
add_face_from_stream
Adicione um rosto a uma pessoa a um grupo de pessoas para identificação facial ou verificação. Para lidar com uma imagem que contém vários rostos, o rosto de entrada pode ser especificado como uma imagem com um retângulo targetFace. Devolve umFaceId persistente que representa o rosto adicionado. Não será armazenada nenhuma imagem.
Apenas a funcionalidade de rosto extraído será armazenada no servidor até que PersonGroup PersonFace - Delete, PersonGroup Person - Delete ou PersonGroup - Delete seja chamado.
Nota persistedFaceId é diferente do faceId gerado por [Face)
Detetar](https://docs.microsoft.com/rest/api/faceapi/face/detectwithurl).
- Uma maior qualidade de imagem facial significa uma melhor precisão de reconhecimento. Considere rostos de alta qualidade: o tamanho frontal, claro e facial é de 200x200 píxeis (100 píxeis entre os olhos) ou superior.
- Cada entrada de pessoa pode conter até 248 rostos.
- O formato JPEG, PNG, GIF (o primeiro fotograma) e BMP são suportados. O tamanho do ficheiro de imagem permitido é de 1 KB a 6 MB.
- O retângulo "targetFace" deve conter um rosto. Zero ou vários rostos serão considerados um erro. Se o retângulo "targetFace" fornecido não for devolvido de Face – Detetar, não é garantido detetar e adicionar o rosto com êxito.
- O tamanho do rosto detetável (36x36 - 4096x4096 píxeis), a pose de cabeça grande ou as grandes oclusões causarão falhas.
- A adição/eliminação de rostos de/para uma mesma pessoa será processada sequencialmente. A adição/eliminação de rostos de/para pessoas diferentes é processada em paralelo.
- O tamanho mínimo de rosto detetável é de 36x36 píxeis numa imagem não superior a 1920x1080 píxeis. As imagens com dimensões superiores a 1920x1080 pixéis precisarão de um tamanho facial mínimo proporcionalmente maior.
- Podem ser fornecidos valores "detectionModel" diferentes. Para utilizar e comparar diferentes modelos de deteção, veja Como especificar um modelo de deteção.
add_face_from_stream(person_group_id, person_id, image, user_data=None, target_face=None, detection_model='detection_01', custom_headers=None, raw=False, callback=None, **operation_config)Parâmetros
- user_data
- str
Dados especificados pelo utilizador sobre o rosto para qualquer finalidade. O comprimento máximo é 1 KB.
Um retângulo de rosto para especificar o rosto de destino a adicionar a uma pessoa no formato "targetFace=left,top,width,height". Por exemplo, "targetFace=10,10,100,100". Se existir mais do que um rosto na imagem, é necessário targetFace para especificar o rosto a adicionar. Nenhum targetFace significa que só é detetado um rosto em toda a imagem.
- detection_model
- str ou DetectionModel
Nome do modelo de deteção. O modelo de deteção é utilizado para detetar rostos na imagem submetida. Pode ser fornecido um nome de modelo de deteção ao efetuar Face – Detetar ou (Grande)FaceList – Adicionar Rosto ou (Grande)PersonGroup – Adicionar Rosto. O valor predefinido é "detection_01", se for necessário outro modelo, especifique-o explicitamente. Os valores possíveis incluem: "detection_01", "detection_02", "detection_03"
- callback
- Callable[<xref:Bytes>, <xref:response=None>]
Quando especificado, será chamado com cada segmento de dados transmitidos. A chamada de retorno deve ter dois argumentos: os bytes do segmento atual de dados e o objeto de resposta. Se os dados estiverem a ser carregados, a resposta será Nenhuma.
- operation_config
Substituições da configuração da operação.
Devoluções
PersistedFace ou ClientRawResponse se raw=true
Tipo de retorno
Exceções
add_face_from_url
Adicione um rosto a uma pessoa a um grupo de pessoas para identificação facial ou verificação. Para lidar com uma imagem que contém vários rostos, o rosto de entrada pode ser especificado como uma imagem com um retângulo targetFace. Devolve umFaceId persistente que representa o rosto adicionado. Não será armazenada nenhuma imagem.
Apenas a funcionalidade de rosto extraído será armazenada no servidor até que PersonGroup PersonFace - Delete, PersonGroup Person - Delete ou PersonGroup - Delete seja chamado.
Nota persistedFaceId é diferente do faceId gerado por [Face)
Detetar](https://docs.microsoft.com/rest/api/faceapi/face/detectwithurl).
- Uma maior qualidade de imagem facial significa uma melhor precisão de reconhecimento. Considere rostos de alta qualidade: o tamanho frontal, claro e facial é de 200x200 píxeis (100 píxeis entre os olhos) ou superior.
- Cada entrada de pessoa pode conter até 248 rostos.
- O formato JPEG, PNG, GIF (o primeiro fotograma) e BMP são suportados. O tamanho do ficheiro de imagem permitido é de 1 KB a 6 MB.
- O retângulo "targetFace" deve conter um rosto. Zero ou vários rostos serão considerados um erro. Se o retângulo "targetFace" fornecido não for devolvido de Face – Detetar, não é garantido detetar e adicionar o rosto com êxito.
- O tamanho do rosto detetável (36x36 - 4096x4096 píxeis), a pose de cabeça grande ou as grandes oclusões causarão falhas.
- A adição/eliminação de rostos de/para uma mesma pessoa será processada sequencialmente. A adição/eliminação de rostos de/para pessoas diferentes é processada em paralelo.
- O tamanho mínimo de rosto detetável é de 36x36 píxeis numa imagem não superior a 1920x1080 píxeis. As imagens com dimensões superiores a 1920x1080 pixéis precisarão de um tamanho facial mínimo proporcionalmente maior.
- Podem ser fornecidos valores "detectionModel" diferentes. Para utilizar e comparar diferentes modelos de deteção, veja Como especificar um modelo de deteção.
add_face_from_url(person_group_id, person_id, url, user_data=None, target_face=None, detection_model='detection_01', custom_headers=None, raw=False, **operation_config)Parâmetros
- user_data
- str
Dados especificados pelo utilizador sobre o rosto para qualquer finalidade. O comprimento máximo é 1 KB.
Um retângulo de rosto para especificar o rosto de destino a adicionar a uma pessoa no formato "targetFace=left,top,width,height". Por exemplo, "targetFace=10,10,100,100". Se existir mais do que um rosto na imagem, é necessário targetFace para especificar o rosto a adicionar. Nenhum targetFace significa que só é detetado um rosto em toda a imagem.
- detection_model
- str ou DetectionModel
Nome do modelo de deteção. O modelo de deteção é utilizado para detetar rostos na imagem submetida. Pode ser fornecido um nome de modelo de deteção ao efetuar Face – Detetar ou (Grande)FaceList – Adicionar Rosto ou (Grande)PersonGroup – Adicionar Rosto. O valor predefinido é "detection_01", se for necessário outro modelo, especifique-o explicitamente. Os valores possíveis incluem: "detection_01", "detection_02", "detection_03"
- operation_config
Substituições da configuração da operação.
Devoluções
PersistedFace ou ClientRawResponse se raw=true
Tipo de retorno
Exceções
create
Crie uma nova pessoa num grupo de pessoas especificado.
create(person_group_id, name=None, user_data=None, custom_headers=None, raw=False, **operation_config)Parâmetros
- user_data
- str
Dados especificados pelo utilizador. O comprimento não deve exceder os 16 KB.
- operation_config
Substituições da configuração da operação.
Devoluções
Pessoa ou ClientRawResponse se raw=true
Tipo de retorno
Exceções
delete
Eliminar uma pessoa existente de um grupo de pessoas. A funcionalidade persistedFaceId, userData, nome da pessoa e rosto na entrada de pessoa será eliminada.
delete(person_group_id, person_id, custom_headers=None, raw=False, **operation_config)Parâmetros
- operation_config
Substituições da configuração da operação.
Devoluções
Nenhum ou ClientRawResponse se raw=true
Tipo de retorno
Exceções
delete_face
Elimine um rosto de uma pessoa num grupo de pessoas por personGroupId, personId e persistedFaceId especificados.
A adição/eliminação de rostos de/para uma mesma pessoa será processada sequencialmente. A adição/eliminação de rostos de/para pessoas diferentes é processada em paralelo.
delete_face(person_group_id, person_id, persisted_face_id, custom_headers=None, raw=False, **operation_config)Parâmetros
- persisted_face_id
- str
ID que referencia umFaceId persistente específico de um rosto existente.
- operation_config
Substituições da configuração da operação.
Devoluções
Nenhum ou ClientRawResponse se raw=true
Tipo de retorno
Exceções
get
Obtenha as informações de uma pessoa, incluindo rostos persistentes registados, nome e userData.
get(person_group_id, person_id, custom_headers=None, raw=False, **operation_config)Parâmetros
- operation_config
Substituições da configuração da operação.
Devoluções
Pessoa ou ClientRawResponse se raw=true
Tipo de retorno
Exceções
get_face
Obtenha informações sobre um rosto persistente (especificado por persistedFaceId, personId e o respetivo personGroupId pertencente).
get_face(person_group_id, person_id, persisted_face_id, custom_headers=None, raw=False, **operation_config)Parâmetros
- persisted_face_id
- str
ID que referencia umFaceId persistente específico de um rosto existente.
- operation_config
Substituições da configuração da operação.
Devoluções
PersistedFace ou ClientRawResponse se raw=true
Tipo de retorno
Exceções
list
Liste todas as pessoas num grupo de pessoas e obtenha as informações da pessoa (incluindo personId, name, userData e persistedFaceIds dos rostos registados da pessoa).
list(person_group_id, start=None, top=None, custom_headers=None, raw=False, **operation_config)Parâmetros
- start
- str
A iniciar o ID da pessoa a devolver (utilizado para listar um intervalo de pessoas).
- top
- int
Número de pessoas a devolver a partir do ID de pessoa indicado pelo parâmetro "start".
- operation_config
Substituições da configuração da operação.
Devoluções
list ou ClientRawResponse if raw=true
Tipo de retorno
Exceções
update
Atualizar nome ou userData de uma pessoa.
update(person_group_id, person_id, name=None, user_data=None, custom_headers=None, raw=False, **operation_config)Parâmetros
- user_data
- str
Dados especificados pelo utilizador. O comprimento não deve exceder os 16 KB.
- operation_config
Substituições da configuração da operação.
Devoluções
Nenhum ou ClientRawResponse se raw=true
Tipo de retorno
Exceções
update_face
Adicione um rosto a uma pessoa a um grupo de pessoas para identificação facial ou verificação. Para lidar com uma imagem que contém vários rostos, o rosto de entrada pode ser especificado como uma imagem com um retângulo targetFace. Devolve umFaceId persistente que representa o rosto adicionado. Não será armazenada nenhuma imagem.
Apenas a funcionalidade de rosto extraído será armazenada no servidor até que PersonGroup PersonFace - Delete, PersonGroup Person - Delete ou PersonGroup - Delete seja chamado.
Nota persistedFaceId é diferente do faceId gerado por [Face)
Detetar](https://docs.microsoft.com/rest/api/faceapi/face/detectwithurl).
- Uma maior qualidade de imagem facial significa uma melhor precisão de reconhecimento. Considere rostos de alta qualidade: o tamanho frontal, claro e facial é de 200x200 píxeis (100 píxeis entre os olhos) ou superior.
- Cada entrada de pessoa pode conter até 248 rostos.
- O formato JPEG, PNG, GIF (o primeiro fotograma) e BMP são suportados. O tamanho do ficheiro de imagem permitido é de 1 KB a 6 MB.
- O retângulo "targetFace" deve conter um rosto. Zero ou vários rostos serão considerados um erro. Se o retângulo "targetFace" fornecido não for devolvido de Face – Detetar, não é garantido detetar e adicionar o rosto com êxito.
- O tamanho do rosto detetável (36x36 - 4096x4096 píxeis), a pose de cabeça grande ou as grandes oclusões causarão falhas.
- A adição/eliminação de rostos de/para uma mesma pessoa será processada sequencialmente. A adição/eliminação de rostos de/para pessoas diferentes é processada em paralelo.
update_face(person_group_id, person_id, persisted_face_id, user_data=None, custom_headers=None, raw=False, **operation_config)Parâmetros
- persisted_face_id
- str
ID que referencia umFaceId persistente específico de um rosto existente.
- user_data
- str
Dados fornecidos pelo utilizador anexados ao rosto. O limite de tamanho é de 1 KB.
- operation_config
Substituições da configuração da operação.
Devoluções
Nenhum ou ClientRawResponse se raw=true
Tipo de retorno
Exceções
Atributos
models
models = <module 'azure.cognitiveservices.vision.face.models' from 'C:\\hostedtoolcache\\windows\\Python\\3.11.8\\x64\\Lib\\site-packages\\azure\\cognitiveservices\\vision\\face\\models\\__init__.py'>
Azure SDK for Python
Comentários
Brevemente: ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja: https://aka.ms/ContentUserFeedback.
Submeter e ver comentários