stingray.Social 네임스페이스 참조

설명

Xbox One의 Social Manager 기능에 액세스하는 인터페이스입니다.

기타 관련 참조 항목

Xbox Live

함수

add_local_user_to_graph ( user_id ) SocialMananager에 사용자를 추가합니다.

매개변수

user_id :

integer

소셜 사용자 관리자 사용을 시작할 사용자의 ID입니다.

반환하는 항목

이 함수는 아무 값도 반환하지 않습니다.

해당 사용자를 사용하여 [stingray.Social.core_social_group] 및 stingray.Social.create_filtered_social_group을 호출하려면 우선 이 작업을 수행해야 합니다.

더 이상 필요 없는 사용자를 SocialManager에서 제거하려면 stingray.Social.remove_local_user_from_graph를 사용합니다.

참고: stingray.Social.last_social_events가 stingray.SocialEventType.RTA_DISCONNECT_ERR를 반환하면 해당 사용자를 SocialManager에 다시 추가해야 합니다.

기타 관련 참조 항목

stingray.Social.create_filtered_social_group() stingray.Social.last_social_events()

create_filtered_social_group ( user_id, presence_filter, relationship_filter ) : integer 제공된 필터가 적용된 소셜 그룹을 SocialManager에 추가합니다.

매개변수

user_id :	integer	해당 소셜 그룹의 기반이 되는 사용자의 ID입니다.
presence_filter :	integer	stingray.SocialPresenceFilter 상수 중 하나여야 합니다.
relationship_filter :	integer	stingray.SocialRelationshipFilter 상수 중 하나여야 합니다.

반환하는 항목

integer

생성된 소셜 그룹의 ID입니다.

그룹 내 구성원에 관한 정보를 가져오려면 stingray.Social.social_group을 사용합니다. SocialManager는 소셜 그룹을 비동기적으로 최신 상태로 유지하기 때문에 이 정보는 언제든 변경될 수 있습니다.

호출 전에, 제공된 사용자가 stingray.Social.add_local_user_to_graph를 통해 SocialManager에 추가되었는지 확인하십시오. 소셜 그룹을 더 이상 사용하지 않으면 stingray.Social.remove_social_group을 통해 제거해야 합니다.

참고: stingray.Social.last_social_events가 stingray.SocialEventType.RTA_DISCONNECT_ERR를 반환하면 해당 소셜 그룹을 다시 생성해야 합니다.

기타 관련 참조 항목

stingray.Social.add_local_user_to_graph() stingray.Social.last_social_events() stingray.Social.social_group()

last_social_events ( ) : integer* 이 함수를 마지막으로 호출한 이후 발생한 이벤트를 SocialManager에서 반환합니다.

매개변수

이 함수는 어떠한 매개변수도 수용하지 않습니다.

반환하는 항목

integer*

stingray.SocialEventType 상수 중 하나가 됩니다. * 표기는 지정된 유형의 인스턴스가 0개 이상 있을 수 있음을 나타냅니다.

참고: stingray.SocialEventType.RTA_DISCONNECT_ERR이 반환되는 경우 stingray.Social.add_local_user_to_graph를 통해 모든 사용자가 다시 추가되어야 하고 stingray.Social.create_filtered_social_group을 통해 생성된 모든 소셜 그룹이 다시 생성되어야 합니다.

기타 관련 참조 항목

stingray.Social.add_local_user_to_graph() stingray.Social.create_filtered_social_group()

remove_local_user_from_graph ( user_id ) SocialManager에서 사용자를 제거합니다.

매개변수

user_id :

integer

소셜 사용자 관리자 사용을 중지할 사용자의 ID입니다.

반환하는 항목

이 함수는 아무 값도 반환하지 않습니다.

기타 관련 참조 항목

stingray.Social.add_local_user_to_graph()

remove_social_group ( social_group_id ) 지정된 소셜 그룹을 SocialManager에서 제거합니다.

매개변수

social_group_id :

integer

제거할 소셜 그룹의 ID입니다.

반환하는 항목

이 함수는 아무 값도 반환하지 않습니다.

해당 소셜 그룹을 더 이상 사용하지 않으면 이 함수를 호출하여 이 소셜 그룹을 불필요하게 최신 상태로 유지하지 않도록 해야 합니다.

기타 관련 참조 항목

stingray.Social.create_filtered_social_group()

social_group ( social_group_id ) : social_user* stingray.Social.create_filtered_social_group을 통해 생성된, 지정된 소셜 그룹을 반환합니다.

매개변수

social_group_id :

integer

해당 구성원을 가져올 소셜 그룹의 ID입니다.

반환하는 항목

social_user*

사용자 그룹 내 사용자에 관한 정보입니다. * 표기는 지정된 유형의 인스턴스가 0개 이상 있을 수 있음을 나타냅니다.

기타 관련 참조 항목

stingray.Social.create_filtered_social_group()