Azure Functions에 대한 SignalR Service 트리거 바인딩

다음 샘플에서는 클라이언트에서 메시지 이벤트를 수신하고 메시지 콘텐츠를 기록하는 C# 함수를 보여 줍니다.

[Function(nameof(OnClientMessage))]
public static void OnClientMessage(
    [SignalRTrigger("Hub", "messages", "sendMessage", "content", ConnectionStringSetting = "SignalRConnection")]
        SignalRInvocationContext invocationContext, string content, FunctionContext functionContext)
{
    var logger = functionContext.GetLogger(nameof(OnClientMessage));
    logger.LogInformation("Connection {connectionId} sent a message. Message content: {content}", invocationContext.ConnectionId, content);
}

C# 프로세스 내 모델에 대한 SignalR Service 트리거 바인딩에는 두 개의 프로그래밍 모델이 있습니다. 클래스 기반 모델 및 기존 모델입니다. 클래스 기반 모델은 일관된 SignalR 서버 측 프로그래밍 환경을 제공합니다. 기존 모델은 향상된 유연성을 제공하며 다른 함수 바인딩과 비슷합니다.

클래스 기반 모델 사용

자세한 내용은 클래스 기반 모델을 참조하세요.

public class HubName1 : ServerlessHub
{
    [FunctionName("SignalRTest")]
    public Task SendMessage([SignalRTrigger]InvocationContext invocationContext, string message, ILogger logger)
    {
        logger.LogInformation($"Receive {message} from {invocationContext.ConnectionId}.");
    }
}

기존 모델 사용

기존 모델은 C#에서 개발한 Azure Function의 규칙을 따릅니다. 잘 모르는 경우 문서에서 배울 수 있습니다.

[FunctionName("SignalRTest")]
public static Task Run([SignalRTrigger("SignalRTest", "messages", "SendMessage", parameterNames: new string[] {"message"})]InvocationContext invocationContext, string message, ILogger logger)
{
    logger.LogInformation($"Receive {message} from {invocationContext.ConnectionId}.");
}

트리거에서 ParameterNames를 사용하기 어려울 수 있으므로 다음 예제에서는 SignalRParameter 특성을 사용하여 message 특성을 정의하는 방법을 보여 줍니다.

[FunctionName("SignalRTest")]
public static Task Run([SignalRTrigger("SignalRTest", "messages", "SendMessage")]InvocationContext invocationContext, [SignalRParameter]string message, ILogger logger)
{
    logger.LogInformation($"Receive {message} from {invocationContext.ConnectionId}.");
}

app.generic("function1",
    {
        trigger: { "type": "signalRTrigger", "name": "invocation", "direction": "in", "hubName": "hubName1", "event": "SendMessage", "category": "messages" },
        handler: (triggerInput, context) => {
            context.log(`Receive ${context.Arguments[0]} from ${triggerInput.ConnectionId}.`)
        }
    })

function.json 파일의 바인딩 데이터는 다음과 같습니다.

{
    "type": "signalRTrigger",
    "name": "invocation",
    "hubName": "hubName1",
    "category": "messages",
    "event": "SendMessage",
    "parameterNames": [
        "message"
    ],
    "direction": "in"
}

JavaScript 코드는 다음과 같습니다.

module.exports = function (context, invocation) {
    context.log(`Receive ${context.bindingData.message} from ${invocation.ConnectionId}.`)
};

다음 표에서는 SignalRTrigger 특성의 속성을 설명합니다.

다음 표에서는 SignalRTrigger 특성의 속성을 설명합니다.